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This publication describes the internal logic of the 
Basic Telecommunications Access Method (BTAM) . It is 
intended for use by persons involved in program 
maintenance and by system programmers who are altering 
the program design. 



PREFACE 



This Program Logic Manual is a guide to 
the internal structure of the Basic 
Telecommunications Access Method (BTAM),. 
It is designed to be used with the program 
listing; program structure at the machine 
instruction level is not discussed. 



Effective use of this manual requires a 
knowledge of the concepts presented in the 
following IBM System/360 publications: 

• IBM System/360; Principles of 
Operation , GA22-b821 



• IBM System/ 360 Operating System: 
System Programmer's Guide , GC28-6550 



IBM System/360 Operating System: 
Fixed-Task Supervisor, Program Logic 
Manual , GC28-6612 



IBM System/ 360 Operating System: 
Input/Output Supervisor, Program Logic 
Manual, GY28-6616 



IBM Systeir/3b0 Operating System: 
Assembler Language , GC28-6514 

IPM System/360 Operating System: Basic 
Telecommunications Access Method , 
GC30-2004 



• IBM General Information 



Binary 



Synchronous Communications , 
GA27-3004 



In addition, the following publications 
may be used when information about other 
elements of the control program is 
required: 

• IBM System/3b0 Operating System: 

Input/Outout Support (OP£N/CLOSE/EOV) , 
Program Logic Manual , GY28-6609 



This publication is divided into three 
sections: a discussion of the general 
organization of the Basic 

Telecommunications Access Method (BTAM) ; a 
summary of the internal logic of each BTAM 
element; and a section illustrating 
internal control blocks and describing 
control conventions. 
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GY30-2001-4 and associated Technical Newsletters GY30-2552 and 
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taining BTAM support for the IBM 3270 Display System. 
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existing pages is indicated by a vertical line to the left of a 
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244.5, and 249-253. 

Changes are periodically made to the information herein; before 
using this publication in connection with the operation of IBM 
systems or equipment, refer to the latest SRL newsletter for the 
editions that are applicable and current. 
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IBM representative or to the IBM branch office serving your locality. 
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INTRODUCTION 



This manual: 

• Describes the iracro instructions and 
routines that make up the Basic 
Telecommunications Access Method; 

• Explains the internal logic of optional 
BTAM facilities, such as Auto Poll and 
dynamic buffering; 

• Shows the formats and contents of the 
control blocks used in BTAM operation; 

• Describes the channel program 
operation for each of the types of 
remote or local stations and line 
configurations supported by BTAM; 

• Describes the method by which BTAM Read 
and Write channel programs are 
constructed; 

• Charts the internal logic of each of the 
BTAM routines; 

• Lists all BTAM modules. 

It is assumed that the reader is 
familiar with the manuals listed in the 
Preface. 



• READ or WRITE (List or Standard 

form) - creates a data event control 
block (DECE). Normally, pne DECB 
will be created for each line or 
local device in the line group. 
The DECB contains the event control 
block (ECB) and serves as a parameter 
list for the READ and WRITE macro 
instructions of the executable form 
(MF=E) • 

2. Macro used to identify a communication 
line group and to specity any optional 
features of 3TAM that are to be 
utilized . 

• ncp - creates and initializes a data 
control block ( 3CB) ^or a 
communication line group. ^his is 
the only DCB essential to BTAM. 

3. Macro used to activate a line group . 

• OPEN - prepares communication lines 
or local devices for use, initializes 
control blocks, and loads BTAM 
routines. 

4. Macro used to correct a line error 
which occurred during Open . 



BTAM MACRO INSTRUCTIONS 

The BTAM macro instructions provide the 
user with his means of control over BTAM. 
They can be divided into ten different 
categories: 



• LOPEN - issues SAD (Set Address) 
or Enable commands to correct a line 
error* For a local 3270 display 
station, LOPEN issues an Erase/Write 
command to unlock the keyboard and 
reset the modified data tags* 



1. Macros used to establish and to modify 
terminal and line control information . 

• DFTRMLST - creates terminal lists 
that contain the characters 
necessary to perform polling, 
addressing, dialing, answering, 
automatic polling, or ID checking. 

• CHGNTRY - allows deactivating or 
activating a polling or addressing 
entry in a terminal list, or 
changing control information within 
an entry, without redefining the 
list. For a local 3270 display 
station, CHGNTRI sets or resets the 
skip flag in the OCB to inhibit or 
permit Read Initial operations for 
the device. 



5. Macros used to keep error counts by 
line and to print error statistics 
messages. 

• LER^ - creates a block to accumulate 
counts of errors and number of 
transmissions? prints a message 
which identifies the line and 
contains the error counters. Error 
counters for data check, 
intervention required, and nontext 
time-out errors are kept by line on 
a threshold basis. a message 
(IEC801I) is printed whenever any of 
the counters reaches its threshold 
value before the transmission count 
is reached, or whenever the 
transmission count reaches its 
threshold value. 
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• LEPPRT - prints at the operator's 
console a message (I^C802I) 
containing the current values of the 
cumulative counters tnat are 
incremented each time a threshold 
error count is reached or the 
transmission count is reached, 
whichever occurs first. 

Macros used to obtain and to release 
buffers , 

• REQBUF - provides one or more 
buffers if they are available. 

• RELBUF - fulfills an outstanding 
buffer request if dynamic buffering 
is specified, or returns a buffer to 
the buffer pool. 

Macros used to control the lines and 
to perform data transmission . 



READ (Execute [MF=E] forir) - uodates 
the DECB parameter list, generates » 
linkage to the BTAM Read/Write 
routine, and causes BTAM to perform 
a specified function (such as 
polling a terminal and reading a 
message into an input buffer area). 



• WRIT*: (Execute [MF=F] form) - is the 
same as READ, except that it 
normally causes BT*M to perform such 
functions as addressing a terminal 
and writing a message to the 
terminal from an output buffer area. 

• RESETPL - forces a Read operation to 
terminate by interrupting a 
repetitive polling operation, or on 
a switched line, forces a Read or 
Write operation to terminate by 
halting an Enable command. For a 
World Trade telegraph terminal, - 
RESETPL forces a Read Initial 
operation to end if the command 
being executed is a Prepare and if 
no characters are being received 
from the terminal. For a local 3270 
display station, RESETPL cancels 

a Read Initial operation that was 
scheduled but not initiated- 



Kacro used to relinquish control of 
the central processing unit . 

• TWAIT - relinquishes control of the 
CPU when the problem program must 
wait for the completion of one of a 
number of events oefore further 
processing can be done. 



10. Macro used to deactivate a 
communication line group . 

• CLOSE - stops I/O activity on lines 

or local devices, frees storage 

obtained by OPEN, and deletes BTAM 
routines. 

BTAM CONTROL BLOCKS 



The BTAM control blocks are used to create 
the telecommunications environment and to 
interface with the operatinq system control 
program. The control blocks are 
information areas that are related to a 
particular facet of the operating system. 
They contain pointers to other blocks, 
control information for the system, buffer 
and device characteristics, etc. This 
section contains introductory information 
on the control blocks in preparation for 
the next section, "Role of the Control 
Blocks in Creating the Access Method." 
Detailed control block descriptions and 
formats are contained in the Aopendices. 



Data Control Block (DCB) 



The data control block (created by a DCB 
macro instruction) serves four functions: 

1. Identifies the access method by a 
combination of data set organization 
(DSORG) and macro-reference (MACRF) . 

2. May soecify that optional facilities 
of the access method are to be used 
for the given line group (for example, 
buffer allocation, error recording, 
error recovery orocedures) . 

3. Contains pointers (after OPEN) to BTAM 
routines and other control blocks. 



Macros used to assemble translation 
tables and to translate message text 
from one code to another . 

• ASMTRTAB - assembles one or more 
BTAxM translation tables with the 
problem program. 

• TRNSLATE - translates characters 
from EBCDIC to transmission code or 
from a transmission code to EBCDIC. 



U. Contains a table of special characters 
(BSC only) . 

The DDNAME parameter of a BTAM DCB 
uniquely identifies a line aroup. For a 
start-stop line group, all lines within 
that line group must be associated with 
terminals of the same type. For a BSC line 
grouo, different types of remote stations 
may oe connected to the same line. The 
lines, however, may be associated with 
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different control unit types (2701, 2702, 
or 2703) . At least one DD statement must 
appear in the job stream for each DCB in 
the problem program. The ddname on the DD 
card must be the same as the DDNAME in the 
DCB for the line group. (Refer to 
Appendix P for a detailed description and 
the format of the DCB.) 

Data Extent Block (DEB) 



One data extent block (DEB) is created in 
supervisor main storage by Open module 1 
(IGG0193M) for each line group. The DEB 
contains a table of IOS appendage 
addresses, unit control block addresses 
for each line or local device, and 
addresses of other control blocks. The 
EIB also contains a list of the 
identifications of all BTAM modules needed 
to support the devices in the line group. 
{See Appendix C for detailed description 
and the format of the DEB.) 

Input/Cutout Block (IOB) 

The input/output control block (IOB) 
provides a means of communication between 
BTAN! and the input/output supervisor (IOS) . 
It is the sole parameter of the IOS execute 
channel program (EXCP) instruction. One 
IOB is created for each communication line 
by Open module 3 (IGG0193Q) or for each 
local 3270 device by the local 3270 Open 
executor (IGG0194P) . 



contains fields used in handling attention 
interruptions. (See Appendix G for a 
detailed description and the format of 
the UCE. ) 



Data Event Control Block (DECB) 



The data event control block (DECB) is 
formed in the user program at assembly time 
by expansion of a READ or WRITE macro 
instruction of the list format (MF=L) or 
standard format (FF operand omitted) . It 
provides communication with the BTAM 
Read/Write module by specifying the 
operation type,, line group, line or local 
device, and terminal list to be associated 
with the Read or Write operation. The 
DECB includes areas for the standard event 
control block and responses to addressing 
and longitudinal and vertical redundancy 
checiks (LRCs and VRCs) . There is a pointer 
to the current or only entry in the 
addressing list, a pointer to the current 
entry in the polling list, and the address 
of a terminal list or an entry therein. 
In addition, there are areas which contain 
information for error recovery. (See 
Appendix F for a detailed description 
and the format of the DECB.) 



Event Control Block (ECB) 



The basic IOB, 6U bytes in length, 
contains pointers to the channel program, 
the event control block, and the terminal 
lists; it provides areas for storing flags, 
sense bytes, the channel status word, and 
the start I/O condition code returned by 
IOS. Appended to each basic IOB is a 
variable length area where the channel 
programs are constructed by the Read/Write 
routine. (See Appendix D for a detailed 
description and the format of the IOB. ) 

Unit Control Block (UCB) 



A unit ccntrol block (UCB) is built for 
each line or local device at system 
generation time and is used by IOS during 
execution to determine the physical device 
address and to direct it to the appropriate 
Start I/O and interrupt subroutines. 
The primary field of the UCB reguiring 
the attention of the BTAM user is the 
device type word, which gives details 
of the stations on the line, that is, 
control unit, adapter, model, and optional 
features, or details about the local 
device. The UCB for a local 3270 device 
includes a graphic devices segment that 



After initiating an I/O operation, the task 
(user program) in control can continue 
processing until it needs the results of 
that operation. At this point, the task 
issues a WAIT or TWAIT macro instruction, 
which signals the supervisor that the task 
cannot proceed until completion of a 
specified event (i.e., the I/O operation). 



The WAIT macro specifies an event 
control block (ECB) adiress, which is the 
first word of the DECP formed ny expansion 
of a READ or WRITF macro instruction of the 
list or standard format. The TWAIT macro 
specifies a list of addresses of ECRs 
representing events await ina completion. 
After a WAIT or TWAIT has n^er issued, the 
ECB contains the wait* flag (set on), the 
completion flag (set off), anci the address 
of the program request block (PPB) . When 
the event is posted, the wait *lag in the 
ECB (or in one of the several i-C^s, for 
TWAIT) is turned off, the completion flag 
is turned on, and a completion code is set 
in byte of the ECB (the completion code 
byte includes the wait and completion 
bits); bytes 1-3 are set to zero. (See 
Appendix E for a detailed description and 
the format of the ECB.) 
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Interruption Requ e st Block (IBB) 



The interruption request block (IRB) is 
used to maintain information about an 
asynchronously executed routine. (See 
Appendix I for a detailed description 
and the format of the IFB.) 

Interruption Queue Element 



The interruption queue element (IQE) is 
used to schedule an asynchronously executed 
routine. (See Appendix J for a detailed 
description and the format of the IQE.) 



ROLE OF THE CONTROL BLOCKS IN CREATING THE 



ACCESS METHOD 



At system qeneration time, 
block (UCB) is established 
in the system. The UCB for 
device contains information 
device, together with contr 
reguired by IOS and BTAM. 
communication line represen 
a UCB is established for ea 
UCB for a line contains the 
address through which the 1 
ultimately accessed, along 
control information require 
ETAM. 



a unit control 
for each device 

a local 3270 

about the 
ol information 
Because each 
ts a device, 
ch line. The 

11-bit hardware 
ine is 
with other 
d by IOS and 



A line group is defined through the 
interaction of the data control block (DCB) 
and the data definition (DD) statement. In 
order to be grouped, the following 
requirements must be met for all lines in 
the group: 

1* All line connections must be either 
switched or nonswitched. 

2. For start-stop lines r all terminals 
connected to the line must be of the 
same type? for BSC lines, any type of 
ESC station that BTAM supports for 
that type of line may be connected to 
it. (For multipoint lines, different 
types of BSC stations can be connected 
to the line.) 

3. All lines share the same buffer pool, 
if a pool is specified. 

**. Dynamic buffering, if specified, is to 
be used for all lines within the line 
group. 

In the simplest case, one DD statement and 
one DCB define a data set and, therefore, a 
line group. (A DCB always defines a line 
group, by definition.) The relationship 
between UCBs and the DD statement is as 
follows: 



If the problem programmer defines, ,at 
system generation time, a unit list 
representing a number of communication 
lines or local devices and 
subsequently refers to that list 
in the UNIT operand of the DD 
statement: 



The line grou 
the specified 
devices. 
The relative 
line or local 
correspond to 
in the unit 1 
ascending ord 
The correspon 
associated wi 
in the same o 



p will consist of 
lines or local 

line number of each 

devices will 

its relative position 
is-t based upon 
er of addresses, 
ding UCEs will be 
th that DD statement 
rder. 



2. The line group can be defined at 
the time of data set definition, 
whether or not unit lists were created 
at system generation time. If the 
UNIT operand names a specific line 
or local devices by its 3-digit 
hexadecimal address, that line or 
local devices will constitute the 
line group. 

3. The data set may be concatenated. A 
concatenated data set is represented 
by a single DCE (and represents a 
single line group)*, but is defined 
through two or more DD statements, 
only the first of which has a ddname. 
The DD statements involved may 
represent any combination of items 1 
or 2 above. The relative line numbers 
of the lines or local devices 
involved, and the order in which 
the corresponding UCB addresses are 
associated with the data set will 
form a continuous series. This 
series is deterttined by the order 
of the lines or local devices with 
respect to the DD statements and 
the order of the DD statements 
themselves. 



At the time that a job begins execution, 
the System/360 Operating System job 
scheduler creates a task I/O table (TIOT). 
The TIOT contains, in addition to other 
control information* a DD entry for each 
data definition associated with the task. 
Each DD entry, in turn, contains a pointer 
to the UCB for each device associated with 
the data definition. A DD entry within the 
TIOT reoresents, therefore, the UCB 
addresses in relative line number order for 
a line group (or for a segment of a line 
group in the case of a concatenated data 
set). 
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When a data set is opened, the BTAM Open 
executor constructs a data extent block 
(DEB) that fully defines the line group in 
terms of the physical devices involved (see 
Appendix A) . Through a series of pointers 
(see program listing for details) „ the Open 
executor accesses the task I/O table. The 
supervisor open routine passes to the 
executor the address of the DCB for the 
data set being opened. Through a field in 
that DCB, initialized by the supervisor 
Open routine, the executor ^inds within the 
TIOT the DD entry for the data set being 
opened. (For a concatenated data set, this 
entry would be the first of two or more 
applicable DD entries. Additional entries 
are contiguous with the entry containing 
the DDNAME, but have a blank-value name 
field.) 

After determining the number of devices 
involved* which affects the length required 
for the DEB, the Open executor issues a 
GETMAIN to obtain the required storage area 
and initializes the DEB. This 
initialization includes moving all 
applicable UCB addresses from the TIOT into 
the DEB. When this step is complete, the 
DEB contains the complete set of UC° 
pointers for the line group, extending 
contiguously from a known starting 
location. This makes it possible to obtain 
the physical address of any device by 
converting the extent number to an offset 
value (relative to the beginning of the 
table of UCB addresses). The DCB for a 
line group points to the DE^ of the line 
group; the relative line number for a given 
line or local devices bears a fixed 
relation to the UCB address of that line 
cr local devices within the DEB. In 
general, the DEB provides the information 
required by other components of the control 
program for I/O operation management. 

After constructing the DEB„ the *TAM 
Open executor performs an extensive 
analysis of the device type information 
recorded in the UCB. (Only the first UCB 
associated with the data set is examined 
because the device type information field 
must be identical for all UCBs in any one 
line group. ) The contents of the device 
type information field of the UCB are 
described in Appendix H. Specification 
errors in the UCB (such as a conflict 
between unit type and adapter type) cause 
an abnormal end of task. 

If no specification errors are detected 
in the UCB, the Open executor begins 
input/output block (IOB) construction. As 
with the DEB, the executor computes the 
amount of main storage required, issues a 
GETMAIN, and then performs the required 
initialization. The number of IOBs to be 



constructed is equal to the "number of 
extents" value that was previously stored 
in the DEB. That value is equal to the 
number of UCB addresses found in the task 
I I/C table (i.e., the number of lines or 
local devices in the line group) . 



I E VOLUTIO N OF THE „ BTAM BEAD C OMMAND 
| F OR REMOTE . STATIONS 

A problem program must undergo three job 
steps before becoming active under control 
of the Operating System: assembly, linkage 
edit, and execution. The Operating System 
itself is the result of a system 
generation. The steps that effect the 
generation of a channel program by a BTAM 
Read operation are: 

1. System Generation 

2. Assembly 

3 . Execution 

a. Open Line Groups 

fc. Head Operations 

Figure 1 illustrates the steps providing 
information for, or modification of, the 
channel program necessary for the execution 
of a BTAM Read operation. The linkage 
editor job step is not included in the 
figure because it does not affect the 
channel program. 

System Generation 



The ICCOtiTRL and IODEVTCE system generation 
macro instructions provide the details of 
the transmission control unit (TCU) and 
remote station equipment (such as adapter 
type, device type, and features) that the 
Open executor needs to determine the 
appropriate device 1/ module to be 
loaded. The information these macros 
provide is placed in the unit control block 
(UCB) for each line group. (See Appendix H 
for the format of UCBs.) 

Other system generation macro 
instructions directly related to BTAM are 
TELCMLIB, which causes the tele- 
communications subroutine library* 
SYS1.TELCMLIB, to be included in the 
operating system, and DATAMGT, in which the 
access method is specified as BTAM. 



As a result of system generation, the 
BTAM routines and macro definitions are 
included in the system library. 



Introduction 13 



Assembly 



ETAM Open executor (module 4) 



All BTAM macros are represented by macro 
definitions in the system library whether 
they are strictly ETAM macros (e.g., 
DFTRMLST and CHGNTRY) or specialized parts 
of system macros used by BTAM (e.g., READ 
and WRITE). 



When the assembler language problem 
program that will be using BTAM is 
assembled, each macro instruction embedded 
in the program is replaced by its 
appropriate macro expansion. The expansion 
may consist of assembler instruction 
statements (e.g., DC and DS) , symbolic 
machine instruction statements (executable 
machine instructions), or both. 



Execution 



A BTAM Read operation, during execution of 
a user program, is shown in Figure 1 to 
consist of those functions performed during 
Open and those functions performed during 
Read. 

The data set (communication line group) 
is usually opened early in the user 
program. In any case, the data set must Pe 
opened before it is referred to by a READ 
or a WRITE macro instruction. Closing of 
the data set (CLOSE macro) is not shown in 
Figure 1. The CLOSE macro is normally 
placed in the user program so it will be 
executed when no more references are to be 
made to the data set. 

Defining the data control block (see 
Appendix B) with the DCB macro and the 
terminal list with the DFTRMLST macro is 
normally done in the definition section of 
the proqram (along with DC and DS 
statements) and does not result in the 
generation of executable machine 
instructions. 

Open Line Groups 



Opening, or preparing, a communication line 
group for use consists of sequentially 
proceeding through: 

1. OPEN macro-expansion coding 

2. System Open routine 

3. BTAM Open executor (module 1) 

4. ETAM Open executor (module 2) 

5. ETAM Open executor (module 3) 



7. System Open routine 

The OPEN macro-expansion coding is that 
system OPEN macro coding that is 
appropriate for a BTAM data set 
(communication line group). Execution of 
this expansion coding provides for 
identifying the specified DCB and for 
issuing a supervisor call (SVC) for the 
system Open routine. Parameters such as 
INOUT, OUTPUT, and INPUT are ignored by 
BTAM. (BTAM always opens for both input 
and output.) 

The system Open routine partially 
initializes the specified DCB and requests 
that ETAM Open module 1 (IGG019 3M) be 
brought into main storage and executed via 
an XCTL macro instruction. (ETAM coding 
consists of a number of modules, or control 
sections, that are loaded and executed as 
separate but related units.) The four BTAM 
Open modules are executed serially in the 
supervisor transient area. They are 
re-entrant and operate enabled in 
supervisor mode. 

BTAM Open module 1 reserves storage for, 
and initializes the DEB (Appendix C). 
Information found in the UCBs created by 
system generation is used for this ourpose. 
BTAM Open module 2 (IGG019UN) is loaded and 
given control via an XCTL macro 
instruction. This module gets main storage 
for a buffer pool, if a pool is needed, and 
builds a chain of buffers. If the line 
group being opened contains BSC devices, 
this module places the BSC table of special 
characters in the DCB. BTAM Open module 3 
(IGG0193Q) is then loaded and given control 
by XCTL. Module 3 gets main storage for, 
and initializes, the IOBs needed (see 
Appendix D) . 

Module U of BTAM Open (IGG0193S) is 
given control via XCTL, initializes IQEs, 
and, using LOAD macros, loads various ^TAM 
routines and appendages: Fead/Write 
routine (IGG019MA), Channel End/Abnormal 
End Appendage (IGG019MB), the device I/O 
modules for the particular type of terminal 
(start-stop) or line configuration (BSC) 
involved, and (for dynamic buffering only), 
the PCI appendage (IGG019MC) and the Buffer 
routine (IGG019MS). The Buffer routine is 
loaded in all cases where a buffer pool is 
defined. All of these modules are only 
loadable and cannot be given control via 
XCTL macros. 

A directory of I/O modules is created 
within a section of the Read/Write module 
and, deoending on the particular tyoe of 
terminal or line, SAD and ENABLE commands 
are issued to the communication lines via 
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the input/output supervisor (IOS). To 
complete the Open process, control is 
passed from BTAM Open module 4 to the last 
load module of system Open and then to the 
user program at the point immediately 
following the OPEN macro expansion. The 
communication lines are then ready for 
operation. 



Specify, in register 13, the address 
of a save area for storing the general 
reqister values when control is nassed 
to the Read/Write routine (unless 
reaister 13 already contains a save 
area address). 



2. Issue a READ macro instruction. 



Read 



The control flow for a Read/Write operation 
without dynamic buffering is shown in 
Figure 2, that with dynamic buffering, in 
Figure 3. This is representative of 
operating a single communication line in 
the system. Many lines may be operated 
concurrently by issuing REA^ macros (or 
WRITE macros) for each line before waiting 
for completion of one or more Read or Write 
operations. 

At the point in the user program where a 
Read operation is desired, the user must 
perform the following in sequence: 



3. Analyze the codes returned by BTAM in 
reaister 15 indicating whether the 
operation was initiated successfully. 



Note: Return codes may be found in 
the publication IBM System/ 360 
Operating System: Basic 
Telecommunications Access Method , 
GC30-2004. 



4. Issue a WAIT or TWAIT macro 

instruction at the point beyond which 
execution is to proceed only after the 
Read operation is complete. 
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5, Analyze the completion code and error 
flags in the data event control block 
to determine if the operation was 
completed successfully. 
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Figure 1. BTAM Read Operation 
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Figure 2. Control Flow for Read/Write Operation With No Dynamic Buffering 



The expansion of a READ macro (List or 
standard form) by the assembler results in 
initializing a DECE (see Appendix F) with 
the parameters specified by the READ macro. 
The DECB is generated or updated by the 
macro expansion and contains within it an 
ECB (see Appendix E) . The DECB is the only 
direct communications link between the 
Basic Telecommunications Access Method 
(BTAM) and the user program. The ECB 
within the DECB is the entity upon which a 
wait is made (i.e., a WAIT macro parameter) 
and in which completion is posted by IOS 
when the Read operation is completed. 

The principal purpose of the Read/Write 
routine is to construct the channel program 
for the particular type of Read or Write 
desired (i.e.. Read Initial, Read Repeat, 
etc.), making use of the device-dependent 
information contained in the appropriate 
device I/O module. Each device I/O module 
contains, along with special characters and 



a table of offsets, a number of model 
channel programs consisting of a sequence 
of one-byte offsets to the channel command 
words, one for each type of operation. 
Each channel program consists of one or 
more channel command words (CCWs) . 



If specified in the DCB macro, dynamic 
buffering (the ability to read variable 
length records) is achieved by altering the 
basic channel program. Following the Read 
Text command are inserted an additional 
Read Text command and two Read Skip 
commands. Each Read command uses the PCI 
appendage to request a buffer through the 
Buffer routine (IGG019MS), for the next 
Read command (see Figure 3) . If the PCI is 
queued and the appendage never receives 
control, the Read command is abnormally 
completed or completed with error and must 
be retried. (For a detailed discussion of 
the dynamic buffering support provided by 
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BTAM, see the next section, "Dynamic 
Buffering.") 

Just as the DECB is considered the link 
between the user program and BTAM, the IOB 
can be considered the link between BTAM and 
the input/output supervisor (IOS). The 
channel program built by the Read/Write 
routine in the IOB field reserved for it 
has its starting address indicated to IOS 
in an IOB field. 

Once the channel program has been built 
and passed to IOS for execution , control is 
returned to the user program, with return 
codes in register 15 to indicate whether 
the initiation of the Read was successful. 
The user program may then proceed with its 
execution up to a point in the program 
where a WAIT or TWAIT is specified for 
completion of the Read operation. 

Execution of the channel program 
proceeds concurrently with that of the user 



program until a channel end or abnormal end 
condition is met in the channel program, 
whereupon IOS regains control and enters 
the Channel End appendage (IGG019MB) . This 
condition may be caused either by 
completion of the Read operation or by the 
need to update and to restart the channel 
program (e.g., polling the next terminal in 
the terminal list after a negative polling 
response) . 

If the Read operation is completed, IOS 
posts completion in the ECB for the line, 
allowing the user program to continue its 
execution. At this point, the user program 
should analyze the completion code and flag 
bits returned by IOS in the ECB (see 
Appendix E) . Further action in the user 
program should be based on the results of 
this analysis. This completes the entire 
Read operation, after which the user 
program may continue processing or handling 
of the message obtained from the remote 
station. 
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Figure 3. Control Flow for Read/Write Operation With Dynamic Buffering 
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SYSTEM FLOW FOR LOCAL 3270 OPERATIONS 
PSING~BTAM 



READ INITIAL OPERATION 



Figure 3A shows the system flow for a 
local 3270 Read Initial operation: 

1. The expansion of a READ TI macro 
instruction issued by the problem 
program calls the Read/Write routine. 

2. The Read/Write routine builds a 
channel program for the specified 
device and issues an IECTRDTI macro 
instruction to tes^t for attentions 
for the line grcup. The expansion 
of IECTRDTI invokes SVC 116 with 

a routing code of zero, giving control 
to the SVC FLIH. 

3. Through the SVC router , control 
passes to the local 3270 BTAM SVC 
routine (IECTSVC) at the entry point 
IECTRDIL. 

4. If an attention exists for the line 
group, the BTAM SVC routine gives 

a return code of zero; if no attention 

exists, the Read Initial reguest 

is queued, and a return code of four 

is given. The BTAM SVC routine 

passes control to the SVC Exit 

routine. 

5* The SVC Exit routine returns control 
to the Read/Write routine. 

6A. If the return code from the BTAM 

SVC routine was four, the Read/Write 
routine marks all lOBs for the line 
group busy and returns control to 
the problem program. 

6B. If the return cede was zero, the 

Read/Write routine initializes the 
IOB for the device that generated 
the attention and issues an IECTATNR 
macro instruction to reset the 
attention. The expansion of IECTATNR 
invokes SVC 116 with a routing code 
of cne, giving control to the SVC 
FLIH. 

7. Through the SVC router, control 
passes to the local 3270 BTAM SVC 
routine (IECTSVC) at entry point 
IECTATRL. 

8. The BTAM SVC routine resets the 
attention and passes ccntrcl to the 
SVC Exit routine. 

9. The SVC Exit routine returns control 
to the Read/Write routine- 

10- The Read/Write routine invokes SVC 

to have the I/O operation scheduled, 
giving control to the SVC FLIH. 

11. The I/O operation is scheduled by 
the EXCP routine, and the SVC exit 
routine returns control to the 
Read/Write routine. 

12- The Read/Write routine returns control 
to the problem program. 



13- When the Read Initial operation 

completes, an I/O interruption without 
attention status occurs, and control 
is qiven to the IOS interruption 
supervisor through a PSW swap. 

14. ICS gives control to the local 3270 
channel end/abneraal end appendage 
to do processing peculiar to the 
device or access method. 

15. The appendage returns control to 
IOS. 

16. When IOS has finished processing, 
it gives control to the I/O FLIH. 

17. The I/O FLIH passes contrcl to the 
task dispatcher, which dispatches 
the highest priority ready task in 
the system. 



READ AND WRITE OPERATIONS 

Figure 3E shows the system flow for local 
3270 Read and Write operations (other 
than Read Initial) : 

1. The expansion of a READ or WRITE 
macro instruction issued by the 
problem program calls the Read/Write 
routine. 

2. The Read/Write routine builds a 
channel program and initializes an 
IOB for the specified device. The 
Read/Write routine issues an IECTATNR 
macro instruction to reset the 
attention. The expansion of IECTATNR 
invokes SVC 116 with a routine code 
of cne, giving control to the SVC 
FLIH. 

3. Through the SVC router, control 
passes to the local 3270 BTAM SVC 
routine (IECTSVC) at the entry point 
IECTATRL. 

4. The BTAM SVC routine resets the 
attention and passes ccntrcl to the 
SVC Exit routine. 

5. The SVC Exit routine returns control 
the Read/Write routine. 

6. The Read/Write routine invokes SVC 

to have the I/O operation scheduled, 
giving control to the SVC FLIH- 

7. The I/O operation is scheduled by 
the EXCP routine, and the SVC Exit 
routine returns control to the 
Read/Write routine. 

8. The Read/Write routine returns control 
to the problem program. 

9. When the Read or Write operation 
completes, an I/O interruption without 
attention status occurs, and control 
is given to the IOS interruption 
supervisor through a PSW swap. 

10. ICS gives contrcl to the local 3270 
channel end/abnormal end appendage 
to do processing peculiar to the 
device or access method. 

11- The appendage returns control to 
ICS. 
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Figure 3A. System Flow for Local 3270 Read Initial Operation 
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Figure 3B. System Flow for Local 3270 Read and Write Operations 
(Other than Read Initial) 
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12. When IOS has finished processing, 
it gives control to the I/O FLIH. 

13. The I/O FLIH passes control to the 
task dispatcher, which dispatches 
the highest priority ready task in 
the system. 



CHGNTRY SKIP OPERATION 

Figure 3c shows the system flow for a 
local 3270 CHGNTRY Skip operation: 

1. The expansion of a CHGNTRY macro 
instruction (with SKIP specified) 
issued by the problem program invokes 
SVC 116 with a routine code of two, 
giving control to the SVC FLIH. 

2. Through the" SVC router, control 
passes to the local 3270 BTAM SVC 
routine (IECTSVC) at entry point 
IECTCHSL. 

3. The BTAM SVC routine turns on the 
skip flag for the specified device 
and passes control to the SVC Exit 
routine. 

4. The SVC Exit routine returns control 
to the problem program. 



CHGNTRY ACTIVATE OPEEATICN 

Figure 3D shows the system flow for a 
local 3270 CHGNTBY Activate operation: 

1. The expansion of a CHGNTRY macro 
instruction (with ACTIVATE specified) 
issued by the problem program invokes 
SVC 116 with a routine code of three, 
giving control to the SVC .FLIH. 

2. Through the SVC router, control 
passes to the local 3270 ETAM SVC 
routine (IECTSVC) at entry point 
IECTCHAL to turn off the skip flag 
for the device. 

3A. If the activate reguest satisfies 
a queued read initial request, the 
BTAM SVC routine enters the 
asynchronous exit effector stage 

2 (AEE2) to schedule the local 3270 
second-level attention routine. 

3B. The ETAM SVC routine passes control 

to the SVC Exit routine. 
i*A. If AEE2 was not entered, the SVC 

Exit routine returns control to the 

problem proqram. 
4B. If AEE2 was entered, the SVC Exit 

routine gives control to the 

asynchronous exit effector stage 

3 (AEE3). 

5. AEE3 calls the second- level attention 
routine. 

6. The second-level attention routine 
initializes the proper IOB and invokes 
SVC to have the I/O operation 
scheduled, giving control to the 

SVC FLIH. 



7. The I/O operation is scheduled by 
the EXCP routine, and the SVC Exit 
routine returns control to the second- 
level attention routine. 

8. The second-level attention routine 
returns control to AEE3. 

9. AEF3 returns control to the problem 
program. 



BESETPL OPERATION 

Figure 3E shows the system flow for a 
local 3270 RESETPL operation: 

1A, The problem program issues a BESETPL 

macro instruction. If no Read Initial 
reguest is gueued, the expansion 
of RFSETPL returns control to the 
problem program. 

1B. The problem program issues a RESETPL 
macro instruction. If a Read Initial 
request is queued, the expansion 
of RESETPL invokes SVC 116 with a 
routing code of four, giving control 
to the SVC FLIH. 

2. Through the SVC router, control 
passes to the local 3270 BTAM SVC 
routine (IECTSVC) at entry point 
IECTRSTL. 

3. The BTAM SVC routine dequeues the 
Read Initial reguest and enters the 
PCSD routine to post the ECB for 
the Read Intitial operation. 

4. The ETAM SVC routine passes control 
to the SVC Exit Routine. 

5. The SVC Exit routine returns control 
to the expansion of the RESETPL macro 
instruction. 

6. The expansion of RESETPL returns 
control to the problem program. 



ATTENTION INTERRUPTION HANDLING 

Figure 3F shows the system flow for local 
3 270 attention interruption handling: 



1. 



2. 



a. 



When an I/O interruption with 

attention status occurs, control 

is given to the IOS interruption 

supervisor through a PSW swap. 

IOS gives control to the local 3270 

first-level attention routine to 

examine the status of the device 

that caused the attention 

interruption. 

If the attention interruption 

satisfies a queued Read Initial 

request, the first-level attention 

routine enters the asynchronous exit 

effector stage 2 (AEE2) to schedule 

the local 3270 second- level attention 

routine. 

The first-level attention routine 

returns control to IOS. 
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5. When IOS has finished processing, 
it gives control to the I/O FLIH. 

6. If AEE2 was entered, the I/C FLIH 
gives contrcl to the asynchronous 
exit effector stage 3 (AEE3) . 

7. AEE3 calls the second- level attention 
rcutine. 

8. The second-level attention routine 
initializes the proper IOB and invokes 
SVC to have the I/O operation 
scheduled , givirg control to the 

SVC FLIH. 

9. The I/O operation is scheduled by 
the FXCP routinc r and the SVC Exit 
rcutine returns control to the second- 
level attention routine. 

10. When the second-level attention 
routine has finished processing, 
it returns control to AEE3- 

11. AEE3 passes control to the task 
dispatcher, which dispatches the 
highest priority ready task in the 
system. 

DYNAMIC BUFFERING 



The dynamic buffering facility, which 
provides the ability to receive or transmit 
a variable amount of data on a Read or 
Write operation, is provided by BTAM only 
when BFTEK=D is specified in the DCB macro 
instruction for the line or line group. 
When it is specified, BTAM loads two 
additional modules: the buffer routine 
(IGG019MS) and the PCI appendage 
(IGGO 19MC). 

There are two levels of support. In the 
first, the user requests one or more 
buffers via the REQBUF macro instruction 
and returns one or more buffers to the 
buffer pool via the RFLBUF macro 
instruction (see Buffer routine discussion 
in the next chapter). In this instance the 
user iray avoid tying up a full buffer on a 
Read operation until a positive response to 
polling is received. 

In the second level, the user specifies 
that ETAM is to supply buffers, including 
the first one, as needed to accommodate the 
received data. (This is applicable only 
for a Read operation.) The user specifies 
this fcy coding f S' as the area operand in 
the READ macro instruction. 

After the user has requested BTAM to 
supply the first buffer or has supplied the 
first buffer himself, BTAM f s buffer 
management will continue to provide or 
return the buffers until data transmission 
is complete. With dynamic buffering, three 
additional CCWs are generated followinq the 
Read Text CCW (if Read operation) or Write 
Text CCW (if Write operation). The channel 
executes this loop of commands until data 
transmission has been completed. 



Fetching of a buffer management CCW by 
the channel causes a program controlled 
interrupt (PCI) which, under normal 
conditions, causes another buffer to be 
supplied (see Program Controlled Interrupt 
(PCI) Appendage discussion). Thus, while 
the channel is reading into (or writing 
from) buffer N, buffer N+l is being 
supplied by BTAM. 

If a buffer is not immediately available 
on a Read operation, a request for a buffer 
is placed in the buffer request queue. If 
the request is not filled before data is 
received for this buffer, the reception of 
this data into main storage is discontinued 
by a Read skip command. If the buffer is 
supplied in time, the PCI appendage changes 
the Read Skip command to a TIC so that 
message text enters the next buffer. 

For a Write operation, the circumstance 
of a buffer being unavailable does not 
occur, because the user has necessarily 
placed the data in a chain of buffers 
before initiating the Write operation. 

See Figure 4 for the logic flow for 
establishing a dynamic-buffering channel 
program. 
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READ INITIAL CHANNEL PROGRAMS USING AUTO 
POLL (MULTIPOINT ONLY) 



On a Read Initial operation that uses the 
Auto Poll facility (whether start-stop or 
BSC) , the Read/Write routine must make a 
number of decisions in order to set up the 
appropriate channel program. These 
decisions are based principally on: 

• Whether the READ macro specified the 
name of a polling list entry, or 
specified • S" , indicating that BTAM is 
to ooll the last-polled entry; 

• Whether the list is of the open or 
wraoaround format; 

• Whether BTAM knows which entry was last 
polled. 

In order to set up the Poll commands, 
the Read/write routine must have available 
the address of some entry in a polling 
list, and must have available, or be able 
to compute from the address of the entry, 
the address of the polling list header 
(this address is three less than the 
address of the first entry in the list) . 
The DEC*, fields DECPOLPT and DECENTRY are 
used in the computation, as follows. 

If the user specified the entry operand 
of the READ macro as 'S' , he wishes for 
BTAM to begin polling with the last-polled 
entry. The index byte for this entry, and 
the address of the first ertry in the list, 
are contained in the DECPOLPT field, unless 
the polling operation beinq set up is the 
first polling operation using this list. 
The Read/Write routine therefore checks 
DECPOLPT to see if an index and an address 
are present. If so, the routine saves the 
index value and subtracts the header length 
from the address of the first entry to 
obtain the address of the list header. 

If, however, the user specified a 
particular entry, rather than * S', (the 
rout'ine checks the DECTYP^ field of the 
DECB to determine this), or if he specified 

• S' but DECPOLPT does not contain an index 
and address, the Read/Write routine obtains 
the address of the entry *rora the DECENTRY 
field. Then the routine scans forward 
through the list containing that entry 
until it encounters a scan stop byte (which 
by definition contains X'FEM, signifying 
the end of the list. From the address of 
this byte and the offset value that follows 
it, the routine computes the address of the 
list header. 

At this point the routine has the 
address of the header and the index of some 
entry in the polling list. Before using 



these values to set up the Poll commands, 
the routine determines whether the Read 
Initial operation is to be executed by the 
On-Line Test or Error Recovery facilities 
of BTAM. If not, the routine determines 
whether all entries in the list are skipped 
or if the polling list usage count has 
reached its limit of 15. (This count 
indicates how many Read operations are 
currently using the list.) If neither of 
these conditions prevails, the routine 
increments the usage count by one and 
proceeds; if either condition is true, the 
channel program cannot be executed and 
control is returned to the user program 
with a return code of X^O* in register 15. 

If the operation is beinq executed under 
On-Line Test or Error ?tecov^ry procedures, 
the routine bypasses the step of checking 
for active entries and usage count, and 
does not increment the usage count. 



Now, the Read/Write routine places in 
DECPOLPT the address of the first entry anl. 
the index of the last-oolle^ or 
user-soecif ied entry, and nroceeds to 
complete setup of the Rt ad Initial channel 
program. 

If the polling list specific d oy the 
REAP macro is of the w^anaroun^ format (the 
routine checks the W bit in the list header 
to determine this), th<^ routine sets ur>, 
following the Poll command, two IIC 
commands and a second ^oll command, and 
places in the second Poll command the 
address of the first entry (which is 
contained in DECPOLPT). This first entry 
is where polling resumes after the first 
pass through the polling list by the first 
Poll command. 

The routine then olaces in the first 
Poll command (or the only Poll command, for 
a list of the open format), the address of 
the entr-y with which rollinq is to beqin. 
This entry will oe the one whose iniex is 
contained in DECPOLPT (i.e., the 
last-polled or user-soecif ied entry) , 
unless that entry is no longer active. Tne 
Read/Write routine steos through the 
polling list from the first entry, 
inspecting each index until it finds one 
that equals the index in DECPOLPT., or the 
first one whose value exceeds the index in 
DFCPOLPT. 

The routine then places in the Po|.l 
command the address of the entry 
corresponding to the index found in this 
manner. If, however, there are no active 
entries whose indexes equal or exceed the 
index in DECPOLPT, the routine places the 
address of the first active entry in the 
Poll command. 
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BTAM ROUTINES AND ASSOCIATED MODULES 



BTAM consists of 108 load modules that 
support 21 routines (considering as single 
routines all error recovery routines and 
all on-line test routines) • Of these 
modules, 74 are executable and 34 are 
device I/O modules containing no executable 
code. 



A complete list of BTAM modules is oiven 
in Appendix I. For convenience, they are 
listed both by module name, in alphabetical 
order, and by name of routine. 

This chapter discusses each of the 
routines and the means by which ETAM 
channel programs are generated. 



Edit Routine (IECTEDIT) 

Line Error Print Routine (IECTLERP) 

Line Open Routine (IECTLOPoJ) 

Translate Routine (IECTTRNS) 

On-Line Testing (see Appendix I for module 
names) 

RKQEUF/RELBUF (SVC 58) Routine 
(IGC058) 

2741 Break Routine (IGG019PK) 

BTAM Close Executor (IGG0203M) 

BTAM Open Executor (IGG0193M, IGG0194N, 
IGG0193O, and IGG0193S) 



BTAM Routines 



The BTAM routines (and associated module 
names) discussed in this section are: 

BTAM Open Executor (IGG01<>3M, IGG0194N, 
IGG0193Q, and IGG0193S) 

I local 3270 BTAM Open Executor (IGG0194P 
I and IGG0194Q) 

BTAM Read/Write Routine (IGG019MA) 

Channel End/Abnormal End Appendace 
(IGG019MB) 

World Trade Telegraph Terminal Channel 
End/Abnormal End Appendage (IGG019PD) 

Local 3270 Channel End/Abnormal End 
Appendage (IGG019PA) 

Program Controlled Interrupt (PCI) 
Appendage (IGG019MC) 

local 3270 First-Level Attention Routine 
(IECTATEN) 



Local 3270 Second-Level Attention Routine 
(IGG109PG) 

Local 3270 BTAM SVC Routine (IECTSVC) 

Error Recovery Procedures (see Appendix I 
for module names) 

Buffer Routine (IGG019MS) 

Change Entry Routine (IECTCHGN) 1 



*The Change Entry routine is present only 
if Auto Poll is used. 



Expansion of the OPEN macro instruction in 
the problem program generates a calling 
sequence containing a supervisor call 
(SVC). Execution of this SVC causes the 
first load of system Ooen to be loaded into 
the supervisor transient area. 

After performing open functions required 
by the system # the supervisor Open routine 
passes control to the BTAM Open executor 
when the DCB for the data set being opened 
indicates that BTAM is the access method to 
be employed. 

The Open executor creates the 
environment under which BTAM operates, 
based upon information provided through a 
user-defined data control block (DCB) for a 
line or line group. (An executor is 
defined as the set of instructions that is 
entered by the supervisor Open routine to 
perform the functions peculiar to an access 
method.) The routine consists of four load 
modules. The first load module (IGG0193M) 
obtains the storage required for the data 
extent block (DEB), initializes the area in 
the DE3, and fills in the addresses of the 
UCBs into the DEB (see Appendix C for the 
format of the DEB) . If the first UCB 
for the line group is far a graphics 
device (that is, byte 3 in the UCBTTP 
field is X'10 f )# control is passed to 
the where- to-go subroutine, which transfers 
control to the first load module (IGG0194P) 
of the local 3270 BTAM Open executor. 
Otherwise, the UCBs are checked in 
connection with the DCB being opened for 
certain invalid conditions which will 
terminate the program with system codes. 
The system code and the invalid conditions 
checked by load 1 are: 

090 A device other than a 

telecommunications device was 
specified in the UCB allocated to the 
DCB being opened. 
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091 An invalid or unsupported 
transmission control unit type was 
specified in the UCB. 

092 An invalid or unsupported terminal 
adapter type was specified in the 

UCB~ 

093 An invalid or unsupported terminal 
type was specified in the UCB. 

094 An invalid or unsupported optional 
feature was specified in the UCB. 

095 The lines allocated to the line group 
were not identical with respect to 
the terminal type and optional 
features. 

096 There was no buffer pool or no 
buffering technique defined for the 
line group. 

097 The current Open requires an 
additional entry in the Device I/O 
Directory, which is already full; 
i.e., the maximum number of different 
device types have already been opened 
since the last IPL (normal maximum is 
16). 

098 Dual Communication Interface E or 
Dual Code Feature B was specified and 
the transmission control unit was not 
a 2701 or the Dual Communication 
Interface or the Dual Code Feature 
was not specified in the UCB. 

Note : For a completion code of 097 , 
additional space in the Device I/O 
Directory can be provided by changing one 
statement in the Read/Write routine. The 
statement following the one labeled IOD 
roust be changed. The duplication factor 
must be increased to correspond to the 
number of different device types being 
used. The nev» Read/Write routine must be 
reassembled and link-edited to SVCLIE with 
RENT, NE, DC as parameters. The IEKI0SUP 
program must then be executed. See the 
System Generation manual, GC28-6554, for 
the procedure in executing this program. 

If load 1 has not terminated the task r 
it transfers control to load 2 cr to the 
local 3270 BTAM Open executor by XCTL. 
(See Charts 01 and 01A for logic flow 
of the first load module) . 

The second load module, IGG019UN, checks 
the DCB to determine whether the user 
defined a buffer pool or specified dynamic 
buffering. If the pool is defined, the 
buffer length is obtained and placed in the 
DCB. If the user specified both buffer 
length and the number of buffers (BUFL and 
BUFNO) , the module obtains the required 
amount of main storage. If the user has 



omitted from the DCB both buffer pool 
information and the BFTEK=D operand, the 
job ends with a system code of 096. 
Otherwise, this module gives control to the 
third load module. (See Chart 01B for the 
logic flow of IGG019UN.) 

The third load module (IGG0193Q) gets 
main storage for the input/output blocks 
(IOBs) required for BTAM internal use and 
for communication with other components of 
the operating system. It then initializes 
the lines by executing the appropriate Set 
Address , Enable, or Set Mode command. (See 
Chart 02 and 03 for logic flow of the third 
load module.) 



The fourth load module (TGG0193S) 
completes the initialization orocess by 
loading into main storage the Head/Write 
routine, the channel end /abnormal end 
appendaqe, the WT teleqraph terminal 
channel end/abnormal end apnen^age (if the 
device is a World Trade telegraph 
terminal), and a device I/O module required 
for channel proqram generation. When 
establishing the device I/O module, the 
third load makes the corresponding entry in 
the device I/O directory. (Se*^ Charts 04 
and OS for logic flow of the fourth load 
module. ) 



The fourth load module checks for 
certain options to loal other modules, if 
necessary. One optional function is the 
creation of a buffer pool that permits the 
user to obtain and release buffers through 
the REQ^UF and RLIiBUF macro instructions. 
The buffer pool is created if the user has 
provide^ the appropriate values in the 
BUFNO and BUFL fields of the data control 
block. (See IBM Systen/360 Operating 
System; Basic Telecommunications Access 
Method . GC30-2004). It the buffer routine 
(IGG019MS) is required it is loaded; the 
program controlled interrupt ( CI) 
appendaae (IGG019MC) is also leaded when 
dynamic buffering is soecifiec'. 

Othe 1 " ootional functions include setting 
up for On-Line Test and Error Recovery 
Procedures if they are required. 



Control flow durinq Open is governed by 
a standard transfer-control subroutine, 
which aopears in all load modules o^ the 
BTAM Onen executor. The subroutine 
transfers control between the *TAM 
executors and other Open executors. Once 
control has been passed to the BTAM 
modules, all BTAM DCBs in the taole 
constructed by the supervisor Open routine 
are processed by that module? however, one 
or more other executors may be in control 
between the BTAM modules. 
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local 3270 BTAM Open Executor (IGG0194P 
an d IG G0194Q) 

The local 3270 BTAM Cpen executor receives 
control from the first load module 
(IGG1093M) of the BTAM Open executor if 
the UCE for the first device in the line 
qroup is a graphics UCB. The local 3270 
Cpen executor creates the environment 
under which BTAM operates, based on 
information in the DCB for the line group 
of local 3270 devices. 

The Open executor has two lead modules. 
The first load module (IGG0194P) : 

• Checks the' UCBs of all devices being 
opened to see whether the devices 
are local 3270 devices- If one or 
mere devices are not local 3270 
devices, the problem program is 
terminated with a system code of 
X«095«. 

• Gets main storage for one ICB for 
each device in the line group and 
initializes the IOBs. 

• Gets main storage for IFB pointers 
if cn-line testing is specified, 

• Tries to initialize each device in 
the line group by means of a 
Write/Erase operation that erases 
the screen, restores the keyboard, 
and resets the modified data tags. 

If this operation fails for a device, 
the system operator is notified, 
and he decides whether to continue 
trying to initialize the device or 
to try to initialize the other devices 
in the line group. (If OLTEP is 
using a device being opened, the 
Open executor does not try to 
initialize the device; instead, it 
sets a flag in the IOB (bit in 
byte of IOBINCAM) and proceeds 
as though a pemanent I/O error 
occurred.) 

• Transfers control to the second load 
module cf the Open executor. 

For the logic flow of the first laod 
module (IGG019UP), see Charts C5B, 05C, 
and 05E. 



• Loads the on-line test control module 
(IGG019PI) and builds an IRB and 

ICE if the module and control blocks 
are needed. 

• Leads the buffer routine (IGG019MS) 
if it is reguired. 

• Loads the local 3270 channel 
end/abnormal end appendage (IGG019PA) 
and places its address into the 
DEBCEA and DEBXCEA fields in the 
appendage table in the DEB. 

• Loads the local 3270 second-level 
attention routine (IGG109PG) and 
builds an IRB and IQE. 

• Initializes the fields in the graphic 
devices segment of the UCB. 

• Leads the Bead/Write routine 
(IGG019MA) and places its address 
into the DCB. 

• Searches the device I/C director 
in the Read/Write routine. If the 
lecal 3270 I/O module (IGG019PH) 
has already been loaded, the 
displacement of its entry in the 
directory is placed into the DCBDEVTP 
field in the DCB. If the local 3270 
I/O module has not teen loaded and 
the device I/O directory is full, 

the problem program is terminated 
with a system cede of X f 097 l . 
Otherwise, the local 3 270 I/O module 
is loaded, the code frcm the DCBDEVTP 
field and the address of the I/O 
module are placed into an entry in 
the device I/O directory, and the 
displacement of the entry is placed 
into the DCBDEVTP field. 

• Clears the entry in the where-to- 
go (WTG) table to show that Open 
processing for the DCB is complete. 

For the logic flow of the second load 
module (IGG0194Q), see Charts 05E and 
C5F. 

The WTG table routine, a subroutine that 
appears in all load nodules of the Open 
executors, controls flow during open by 
transferring control among the BTAM Open 
executor, the local 3270 BTAM Open 
executor, and other Open executors. 



The second load module (IGG0194Q) : 

• Checks the DCB to see whether a 

buffer pool is defined or reguested.. 
If a buffer pool is defined (that 
is, BUFL and BUFCB were specified) , 
the buffer length is placed into 
the DCB. If a buffer pool is 
reguested (that is, BUFL and BUFNO 
were specified) , main storage is 
obtained, and the buffer pool is 
constructed. If dynamic buffering 
is reguested, the request is ignored. 



BTAM Read/Write Routine (IGG019MA) 



The Read/Write routine is entered from a 
problem program using BTAM through the 
linkage generated by expansion of either 
the READ or WRITE macro instruction or from 
Error Recovery Procedure or On-line Test 
routines. (€ee Charts Al through A 4 for 
the logic flow of IGG019MA. ) The 
Read/Write routine acts as an intermediary 
between the calling routine and the 
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input/output supervisor (IOS) . The 
Read/Write routine performs the following 
functions: 

• Selects the ICB for the line specified 
by the calling routine. 

• Accesses the device I/O module; 
computes, if necessary, the area 
address and length; sets up, if 
necessary, additional CCWs (as for Auto 
Poll and dynamic buffering) ; and loops 
on the CCW count until all CCWs have 
been moved and completed in the channel 
program area of the IOB for the line. 

• For a local 3270 Read Initial request, 
passes control (by issuing IECTRDTI, 
and internal macro instruction that 
invokes SVC 116 with a routing code 

of zero) to the local 3270 BTAM SVC 
routine (IECTSVC) , which checks for 
an attention interruption and queues 
the Read Initial request if none 
exists* 

• For any local 3270 Read or Write 
reguest, passes control (by issuing 
IECTATNR, an internal macro 
instruction that invokes SVC 116 
with a routinq code of one) to the 
local 3270 BTAM SVC routine (IECTSVC), 
which resets the attention flag and 
updates the attention count, 

• Issues an execute channel program SVC 
(EXCP) , passing control to the I/O 
supervisor with the address of the IOE 
as a parameter. Before giving an EXCP 
macro instruction to start the channel 
program, BTAM tests whether the program 
employs a terminal list of the SSALST 
or SSAWLST form. If so, the usage 
count field (indication of the total 
number of polling operations using the 
terminal list at any one time) of the 
terminal list is incremented by 1. 

The CCWs in the device I/O modules are 
complete except for the area address and 
count fields. An index in bytes 1 and 6 of 
the CCW determines which subroutine is 
branohed to to complete either the area 
address or the count. If an offset to the 
normal address is required, this value 
already exists in the CCW. 

Read/Write Subroutines to Compute Area 
Address 

The subroutines for computing the area 
address are: 

Index 
Value 
(hex) Subroutine 

00 TESTLNG - If the area address index 
byte is 00, the Read/Write routine 
then goes directly to compute the 
length. 



04 CATAREA - The fourth byte of the CCW 
is added to the address of the area. 
The area address is the DECAREA field 
in the DECE for this Read or Write 
operation. This subroutine computes 
the area address for a Read or Write 
text or Read Response CCW, If there 
is a Read Response CCW, then it will 
read into the first two bytes of the 
area, and the Read text CCW which 
follows will read into the original 
area address plus two, 

08 RESPAREA - The address of the response 
field in the DECB (DECRESPN) is loaded 
into the area field of the CCW to read 
the response to addressing or to text. 

0C SPECCHAR - The address of the special 
character field is loaded in the area 
field of the CCW before going to 

TESTLAST, 

10 LIST - The fourth byte of the CCW, 

which is a one-byte offset, is added 
to the address of the terminal table 
entry that contains the dial 
characters. A one- byte offset is used 
to bypass the one-byte number which is 
the number of dial characters. The 
number of dial characters is moved to 
the count field. This sets up the 
field to dial a station on a switched 
line, 

14 PALIST - The DECTYPE field in the DECB 
is tested to see if the user specified 
the 'S* operand. If so, the offset in 
the CCW is picked up to load the 
polling or addressing pointer, if 
necessary. The count of characters is 
added to the station address. The 
subroutine finds the first nonskipped 
polling or addressing entry and places 
its address in the CCW, 

18 TWXIDENT - The number of dial 

characters plus one is added to the 
list address and then the number of ID 
characters is moved into the count 
field. The address of the ID 
characters is placed in the area 
address field of the CCW. 

1C PA1050D - The address of the 

addressing characters in the 1050 Dial 
list is placed in the area address 
field. 

20 DISABLE - The entry is checked to see 
if it is in an answering list. If it 
is, then an Enable CCW is set up 
instead of a Dial CCW in the channel 
program area. 

24 AUTOPOLL - Barring exceptional 

conditions, this subroutine sets up 
the Poll and NOP or TIC commands of 
the channel programs used with Auto 
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Poll lists (open or wraparound) . It 
also increments the usage count for 
the lists. 

Exceptional conditions (the 
appropriate register 15 return code is 
set) : 

1, All entries are skipped. 

2. The usage count is at its maximum 
value. 

28 ESCCHARS - The fourth byte of the CCW,, 
which is the relative location of the 
control characters within the DCB f is 
added to the base address of the 
control characters. The resultant 
address which is the location of the 
control characters, is stored in the 
area field of the DCB. 

2C ESCDIAL - The first byte of the 

terminal list built by DFTRMLST is 
tested to see if the list is an 
answering list. If so, an Enable CCW 
is moved into the channel program to, 
replace the Dial command and the CCW 
counter is incremented past the Write 
Inquiry, Read Response, and Write EOT 
commands. If the list is a dial list 
(calling list) , the dial count is 
stored in the count field of the CCW. 
The fourth byte of the CCW is added to 
the address of the dial characters and 
stored in the address field of the 
CCW. 

30 ESCIDEOT - The dial character count is 
added to the list address and used as 
a base to obtain the number of 
characters in the remote device* s 
identification sequence. Twice this 
number plus an offset of 1 is added to 
the base and used as an address to 
obtain the number of characters to be 
transmitted. The number of characters 
to t>e transmitted is added to the 
fourth byte of the CCW and stored in 
the address field of the CCW. 

34 ESCRESP - The DLCSNDPT field (1 byte) 
is added to the address of the DCB and 
stored in the area field of the CCW. 
This allows the proper response to be 
transmitted from that address. 

38 ESCWARLA - The fourth byte of the CCW 
is added to the address of the write 
area and stored in the address field 
of the CCW. 

3C ESCGRAPH - Places in a Write graphics 
CCW the address of graphic characters, 
for BSC Write Leading Graphics 
operations. 

40 BSCADRS - Places in a Read Response 

CCW the address of the area specified 



in the DECRESPN field of the DECB and 
sets the command chain flag in the 
CCW, if necessary. 

44 WTTAWRU - If the operation is a Read 
Initial with ID Exchange, the address 
of a WRU byte, if WRU is coded YES in 
the DCB, is placed in the area address 
field. If WRU is coded NO or is 
absent, the address is that of a 
letters shift character. To construct 
the Write CPU ID and Read Terminal ID 
CCWs, the CPU and terminal 
identification addresses are found as 
defined by the DFTRMLST macro 
instruction. 

If the operation is a Write Initial 
or Write Continue, the address of the 
Pad characters is placed in the area 
address field, and the count is placed 
in the count field of the CCW. 

48 WTTASNS - When the operation is a Read 
Initial, the response field byte of 
the DECB is set to X'FF'. 

4C WRITTONE - Places in the CCW the 

address of a user-specified data tone 
(for BSC manual callinq operation) . 

50 CNTCHARS - Places in a Write CCW that 
sends frame change characters to a 
2760 the address specified in the 
DECENTRY field of the DECB. This 
subroutine is used for Write TIO or 
Write TCO operations for a 2760 on a 
nonswitched line, or Write TCO or 
Write TVO operations for a 2760 on a 
switched line. 

54 FRAMECH - Computes, and places in the 
Write CCW that sends frame change 
characters to a 2760, the address of 
the frame change characters in the 
terminal list used for the Write 
operation. 

58 SWIDREC - Places the address and 

length of the terminal list read-in 
area in the Read ID ENQ CCW. 
(Terminal list of SWLST form) 

5C SWIDSENT - Places the address and 

length of the ID ACK-0 sequence from 
the terminal list into the Write ID 
ACK-0 CCW. 

60 SWLSTTIC - Places the address of the 

Enable CCW in the address field of the 
TIC CCW. 

64 RCJRPOS - Places the address frcm 

the DECENTRY field in the DECB into 
the CCW used to set the buffer address 
for a local 3270 Read IMP or Bead 
IBP. (If the second byte of the 
area specified by the entry operand 
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of the READ macro instruction does 
net contain an SBA order, control 
is returned to the problem program 
with a return cede of X , 24 l in 
register 150 



Read/Write Subroutines to Compute Count 



The subroutines for computing the count 
field, if not already computed, are: 

00 TESTLAST - The count need not be 

computed as the required count is in 
the model CCW; the TESTLAST subroutine 
determines if the current CCW is the 
last one in the channel program. 

04 DATALNG - Obtains from the DECLNGTH 
field of the DECB the count for the 
Bead or Write CCW, subtracts from this 
the value of the CCW count field, and 
places the result in the CCW count 
field. 

08 ESCWLNG - Obtains from the DECWLNG 

field the length for the Read or Write 
CCW, and places it in the CCW count 
field. 

0C CONVLENG - Compares the count in the 
DECLNGTH field with 20 (decimal); if 
the count exceeds 20, passes control 
to TESTLAST, as another CCW must be 
built to accommodate message text. If 
the count does not exceed 20, one CCW 
is sufficient to accommodate the 
expected data, and the subroutine 
places the count in the CCW count 
field, turns on the last-CCW flag (bit 
0) of the TP-Cp code field of the CCW, 
and turns off the chain data flag. 

3C BSCGRAPH - Places in a Write graphics 
CCW the address of graphic characters, 
for BSC Write Leading Graphics 
operations. 

40 ESCADRS - Places in a Read Response 

CCW the address of the area specified 
in the DECRESPN field of the DECB and 
sets the command chain flag in the 
CCW, if necessary. 

If dynamic buffering is specified, the 
subroutine DBDATA is entered from DATAREA. 
This subroutine sets up the additional CCWs 
that are needed and modifies the 
appropriate fields (area address, flags, 
TP-Op code, and count). 



Channel End and Abnormal End Appendage 
(IGG019M6) 



The channel end/abnormal end appendage 
receives control froir the I/O supervisor 



when a channel end interrupt or an abnormal 
end interrupt occurs in connection with a 
channel program generated by the Read/Write 
routine. (An appendage is defined as the 
set of instructions that is entered by the 
I/O supervisor to perform the interrupt 
handling functions peculiar to an access 
method.) The appendage is entered through 
a pointer established in the IOS appendage 
table, which is accessed through a pointer 
placed in the DEB by the BTAM Open 
executor. 

The primary function of the appendage is 
to initiate any further channel operations 
that are to be performed after the basic 
channel program generated by the Read/Write 
routine is interrupted by channel end 
(i.e., when polling, restart, or multiple 
addressing was specified in the basic 
channel program) . The appendage also posts 
buffers (via supervisor Post routine) if 
dynamic buffering is in use, and updates 
the DECB sense (DECSENSO) , command code 
(DECCMCOD) , and CSW status (DECCSWST) 
fields. The appendage also changes remote 
3270 RFT messages to a standard BTAM 
format and stores information and sets 
flags in the IOB when a remote 3270 error 
status message is received. The appendage 
runs in supervisor mode, disabled. See 
Charts B1 through B5A for the logic flow 
of IGGC19MB. 



Two sets of subroutines can be accessed 
as outlined in the following list. The 
second column shows the subroutine accessed 
at abnormal completion (either unit check, 
program check, protection check, channel 
data check, channel control check,, 
interface control check, or chaining 
check) . These subroutines are accessed via 
an abnormal end appendage entry. The third 
column shows the subroutine accessed at 
normal completion. 

When an automatic polling operation 
terminates, either normally or with 
permanent error, the usage count (an 
indication of the total number of polling 
operations using the terminal list at any 
one time) of the terminal list employed is 
decremented by 1. If, additionally, the TP 
code of the last-executed CCW is not less 
than the code for Read Index (this 
indicates that an index byte has been read 
from the channel), BTAM moves the last-read 
index from byte of the user's I/O area 
(or from byte 4 of the user*s first buffer 
if dynamic buffer allocation is being used) 
to byte 36 of the DECB (DECPOLPT). After 
completion is posted to the DECB, the user 
may determine from the stored index byte 
the identity of the responding station and 
the action he wishes to take. BTAM uses 
this byte, hence it should not be modified 
by the user. 
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Abnormal 


Normal 


TP-Op Code 


Completion 


Completion 


00 


TP00AB 


TP00 


01 


TPXX 


TP01 


02 


TP02AB 


TP02 


03 


TP03AB 


TP03 


04 


TPXX 


TPXX 


05 


TP05AB 


TP05 


06 


TPXX 


TP06 


07 


TPXX 


TP07 


08 


TPXX 


TPXX 


09 


TP09AB 


TP09 


0A 


TP0AAB 


TPXX 


OB 


TP0BAB 


TBOB 


OC 


TPXX 


TPOC 


10 


TP10AB 


TP10 


11 


TP10AB 


TP10 


12 


TP12&B 


TP12 


13 


TPXX 


TPXX 


20 


TP21AB 


TP2A 


21 


TP21AB 


TP2A 


22 


EXIT 


EXIT 


23 


BRKTST 


BRKTST 


24 


EXIT 


EXIT 


25 


TP25 


TP25 



See charts Bl through B5A for the functions 
performed by these subroutines. 



World Trade Telegraph Terminal Channel End 
and Abnormal End Appendage (IGG019PD) 

This appendage receives control from the 
I/O supervisor when a proqram controlled 
interrupt, a channel end interrupt, or an 
abnormal end interrupt occurs in connection 
with a channel program generated by the 
Read/Write routine. 

The primary function of this appendage, 
when dynamic buffering is specified, is to 
give control immediately to the PCI 
appendage if the PCI bit is alone in the 
channel and unit status. If the PCI bit is 
present at the same time as CE and DE, if 
no characters have been read, and if this 
is the first PCI, control returns to IOS. 
If this is not the first PCI, before again 
giving control to IOS, the appendage must 
find the CCW preceding the last one used, 
in order to store its address, incremented 
by 8, in the channel status word. This 
address is used to find easily the address 
of the last buffer when IOS again gives 
control to the Channel End appendage. 

If the PCI bit is not present, the 
appendage analyzes the channel and status 
bytes. For all commands of World Trade 
Telegraph operations, channel end, device 
end, unit exception, and unit check can be 
considered aB normal conditions. All the 
other conditions are considered as errors 
and control is given to the channel 
end/abnormal end appendage (IGG019MB) to 
take the appropriate action. 



TP01: A Prepare command has been halted 
by a Halt I/O as a result of a 
RESETPL macro instruction (second 
operand omitted) , or the line has 
failed. 

If only CE, DE, and UE are 
present and the last command is a 
Prepare coirmand, the EOT flag is 
set in the status flags 
(DECFLAGS) of the DECB, the IOB 
exception flag is turned OFF, the 
RESPN byte is reset, and channel 
end goes to TPXX to give control 
to the normal channel end 
appendage. (When a RESETPL is 
successful there is no 
transaction [no data has been 
transferred]. Therefore, the 
transmission count is decreased 
by one since the normal appendage 
[IGG019MB] increases this count 
by one in any case.) 

If, only CE and DE or CE, DE, 
and UC are present and the last 
command is a Prepare command, a 
character was entering the data 
register of the adapter. Channel 
end executes the next command in 
order to read the characters that 
are entering. 

HIOREAD: A Read command has been halted oy 
a Halt I/O as a result of a 
RESETPL macro instruction. The 
CCW is updated and control goes 
to IOS in order to reexecute the 
Read command. 

TP07: If the ID from a WT terminal does 
not match the expected ID, 
channel end goes to TPXX. If the 
ID does match, channel en3 qoes 
to IOS to restart the channel 
program. 

TP11: If the last command is a Read 
command, a check is made to 
determine whether at least one 
character has been read. If no 
characters have been read, a test 
is made to determine whether UC 
is present with CE and DE. 

If the time-out bit is present 
in the sense byte, the EOT flag 
is set in the status flags 
(DECFLAGS) of the DECE, the IOB . 
exception flag is turned OFF, and 
channel end goes to TPXX to give 
control to the normal channel end 
appendage. 

If the lost data bit is 
present in the sense byte, it is 
reset and channel end goes to 
TPXX. If one or more characters 
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have been read, a test is 
performed to determine whether 
the last character is I AM or EOT. 

If the last character is IAM f 
the WRU flag is turned ON in the 
status flags (DECFLAGS) of the 
DECB. Then, if the last 
character is I AM, EOT, or EOM, 
the residual count in the IOB is 
incremented by 1; that is, the 
number of characters read is 
decremented by 1. In all cases, 
a check is made to determine 
whether dynamic buffering was 
used, and to take the appropriate 
action. 

If CE, DE, and UE are present 
and the last command is a Write 
command, or if UC is present and 
if the data check bit is in the 
sense byte, the IOB exception 
flag is turned OFF, the sense 
byte and the CSW are saved, and a 
Write Break is executed. 

If error counts are specified, 
the data check counter is updated 
and is compared with the 
threshold data check counter; if 
unequal, channel end goes to 
TPXX. If equal, the IOB 
exception flag is turned ON so 
that the error recovery procedure 
can print the appropriate 
message. 

TP23: The last CCW is a Write Break, so 
the sense byte and the CSW are 
restored, the contention flag is 
posted in the DECB, and channel 
end goes to TPXX. 

TPXX: Restores the registers and gives 
control to the normal channel 
end/abnormal channel end 
appendage (IGG019MB) . 

local 3270 Channel End/Abnormal End 
Appendage"" (IGG019PA) 



The local 3270 c 
appendage receiv 
supervisor (IOS) 
abnormal channel 
for a local 3270 
by the Bead/Writ 
IOS uses the add 
appendage table 
3270 BTAM Open e 
the appendage. 



hannel end/abnormal end 
es ccntrcl from the I/O 
when a channel end or 
end interruption occurs 
channel program generated 
e routine (IGGC19MA) . 
ress palced into the 
of the DEB ty the local 
xecutor when it loaded 



Retries channel programs that the 
local local 3270 EBP cculd not retry. 
Responds to local 3 270 reguest-for- 
test (BFT) messages or recognizes 
that an on-line test is in progress. 
Recognizes that OLTEP is using a 
device. 



The appendage places the residual count 
from the IOBCSW field in the ICB into 
the DECCCUNT field in the DECB. It places 
the status bits frcm IOBCSW into the 
EECCSWST field in the DECB. If abnormal 
channel end occurred because of unit 
check, the appendage places the sense 
data from the IOBSENS0 field in the IOB 
into the EECSENS0 field in the DECB. 



The local 3270 channel end/abnormal end 
appendage: 

• Places information into ccntrol block 
fields. 



If (1) bits 2 and 5 in t 
field are zero, or (2) bit 
is one and bits 5-7 in byte 
IOEERRCT field are 010, 011 
or (3) bit 5 in I0BFLAG1 is 
IOEECBCC field contains X»4 
appendage sets IOBERBCT to 
eff the busy bit (bit 1 in 
field) in every IOB (if the 
was Read Initial) or in the 
operation only (if the oper 
Bead Initial and a Read Ini 
is not pending) , and return 
IOS. 



he I0BFLAG1 
5 in IOBFLAG1 

2 in the 
, 101, or 110, 

one and the 
4', the 
zero, turns 
the IOBINCAM 

operation 

IOB for the 
ation was not 
tial operation 
s ccntrol to 



If the local 3270 EBP indicated that 
the appendage should retry the channel 
program (that is, bit 2 in the IOBFLAG1 
field is one and bits 5-7 in byte 2 in 
the IOBERBCT field are 111), the appendage 
sets the IOBFLAG1, ICBFLAG2, IOBSENS0, 
I0BSEHS1, I0BFLAG3, and IOBCSW fields 
to zero, sets the IOEECBCC field to X f 7F», 
sets byte 2 in IOBEBBCT to X^S 1 , and 
returns ccntrcl to ICS+8. 

If a local 3270 RFT message was received 
(that is, the first three bytes of the 
input area contain SOH % /) , the appendage 
converts the message to a s-tandard BTAM 
RFT message, places the address of the 
message into the IOBERINF field, schedules 
the on-line test, and returns control 
to IOS+4. If an on-line test is in 
progress (that is, bit 7 in byte 1 of 
the ICBINCAM field is one) , the appendage 
schedules the on-line test, and returns 
control to IOS+4. 

If CLTEP is using a device (that is, 
bit 1 in the control byte in the UCB is 
one) , the appendage turns on bit 7 in 
the DJSCFIAGS field in the DECB, and returns 
control to IOS. 

For the logic flow of the local 3270 
channel end/abnormal end appendage 
(IGG019PA), see Charts B9 and B10« 
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PCI (Program Controlled Interrupt) 
Appendage (IGG019KC) 



Normally f program controlled interrupts are 
processed within a short time after the 
channel command word is fetched by the 
channel. The PCI appendage is entered from 
the ICS interrupt handler or from the WT 
terminal channel end/abnormal end appendage 
(IGG019PD).) 

Dynamic buffering uses the program 
controlled interrupt feature to provide 
program control over the assigning of 
buffers to the Read or Write CCWs. For 
Read operations the PCI allows BTAM to 
obtain a buffer from the buffer pool or to 
set up the next Read command, and if other 
than the first buffer, to post the previous 
buffer. For Write operations the PCI 
indicates that BTAM is to obtain the 
address of the next buffer from the current 
buffer, (low-order three bytes of the first 
word in the buffer) , and to set up the next 
Write command. The PCI appendage will post 
all buffers; on the first PCI there is no 
buffer to post since the first PCI fetches 
the first buffer. 

With dynamic buffering, each Read or 
Write text CCW causes a PCI. The PCI 
appendage sets up a Duffer address and 
alters the existing CCWs. This Read or 
Write cycle with PCIs will continue until a 
channel end interrupt occurs (end of block 
or end of transmission, or an error 
condition). (See Chart CI for logic flow 
of PCI appendage) . 

The chain of commands that perform the 
Read or Write text operations with dynamic 
buffering has four CCWs. Initially 
constructed by the Read/Write routine, the 
four CCWs are actually a loop consisting of 
alternate Read or Write text commands and 
Read skip or transfer- in-channel (TIC) 
commands (see Figure 5). The Read skip or 
the invalid TIC (TIC with an invalid 
transfer address) prevents the Read or 
Write text CCW (other than tne first) from 
being executed until the PCI appendage has 
updated the next'Read or Write CCW with the 
proper buffer address. After the buffer 
address has been updated, the Read skip or 
invalid TIC is altered to a TIC for the 
next Read or Write text CCW. 

Read Operations-Exceptional Conditions : 
The PCI flag in a CCW fetched on data 
chaining normally causes the interruption 
to occur within one character time after 
the CCW is fetched. The time of 
interruption, however, depends on the CPU 
model and the current activity in the 
system and may be delayed even if the 
channel is not masked. The unpredictable 
nature of the interruption time is further 



complicated by the fact that on thp 
multiplexer channel the interruption may 
occur only between character times. 

As a result of the preceding 
considerations, precautions must be taken 
to ensure that if the PCI is delayed so 
that there is not time to get a buffer, the 
read operation will terminate in an 
acceptable manner. Each of the two Read 
text commands in the loop is followed by a 
Read command with the PCI and Skip flags 
on, so that if the PCI on the Read text 
command fails to occur in time, the Read 
skip command is executed (with a large 
count). The Read skip command continues 
reading data into the channel, but ^oes not 
place the data into main storage. Thus, 
termination of the Read operation occurs at 
the normal time, when SOB or EOT is 
received, and the line has been cleared of 
data, so that the problem program may 
request retransmission of the message. 
After the Read skip completes, bit 4 of 
DECFLAGS is turned on. 

The PCI flag in the Read skip command 
serves as an indication to post the 
previous buffer and to free the unused 
buffer in the event that one was supplied, 
but was not obtained in time for the Read 
operation. 

The second exceptional condition occurs 
when the PCI does occur in time, but no 
buffer is available. In this case, the IOB 
for the line is chained to a buffer request 
queue (two pointers are maintained in the 
access method section of the DEB for this 
purpose) . The buffer request queue has 
first priority for any buffers that are 
released via the buffer (PEQBUF/RELBUF) 
routine. If a buffer becomes available 
while the request is active, it is assigned 
to the Read operation by the Buffer 
routine. If no buffer becomes available, 
the PCI flag in the Read skip serves as an 
indication to dequeue the buffer request 
and to post the previous buffer. The PCI 
appendage also frees any buffer that became 
available too late for the Read operation. 

Write Operations - Exceptional Conditions : 
The first condition described in the 
preceding section may also occur for Write 
operations, but it is much simpler to 
handle. If this condition occurs, an 
invalid TIC command is executed causing a 
program check, which causes the abnormal 
end appendage to be entered. This 
appendage gets the next buffer address and 
restarts on the next Write command. 



The second condition cannot occur for 
Write operations. When a PCI occurs on a 
Write text command, the address of the next 
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START 



First buffer being filled 



Second buffer being filled 



nth buffer being filled 
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Before PCI on Read A 



After PCI on Read A and 
before PCI on Read B 
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Figure 5, Dynamic Buffering Read/Write CCWs 



buffer is obtained from the current buffer, 
and the next Write command is updated with 
the buffer address. If the next buffer has 
a chain address of zeros, the chain data 
flag is turned off in the next Write 
command so that the operation terminates on 
that command. The count for the last Write 
command is taken from the DECB (DECLNGTH). 
The TIC command is made valid by updating 
the address to point to the next Write 
command. 

Local. 3270 First-Level Attention 
Routine (IE CTAIEN) 

Turing system generation, the address 
of the local 3270 first-level attention 
routine (IECTATEN) , which is resident 
in the nucleus, is placed into the 
attention routine table (ATHTAB) , and 
an index that gives the position of the 
address in the table is placed into the 
OCBATI field in the UCBs for local 3270 



devices. When the I/O supervisor (IOS) 
receives control after an I/O interruption 
from a local 3270 device and finds the 
attention bit on in the CSW, ICS uses 
UCEATI and ATNTAB to locate the first- 
level attention routine and branches to 
it. 

If the local 3270 device is not part 
cf an open line group (that is, the IRB 
address field in the UCB is zero) , the 
attention routine returns control to IOS^ 
If an error occurred (that is bits other 
than attention and device end are on in 
the CSW) i the attention routine turns 
on the intercept flag (bit 3 in the UCBFL1 
field) in the UCB and returns control 
to IOS+4. If the skip flag (bit 6 in 
the control byte in the UCB) is en, the 
attention routine turns on the attention 
flag (bit 7 in the control byte) , and 
returns control to IOS. 
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If the ship flag is not on and the 
attention flag is on, the attention routine 
returns control to ICS. If the attention 
flag is r.ct on the read initial pending 
flag (kit 5 in the control fcyte in the 
UCB that has device index of one) is not 
en, the attention routine adds one to 
the attention count field (in UCB that 
has a device index of one) , sets the 
attention flag (in the UCB for the device 
that caused the attention interruption) , 
and returns control to IOS. If the read 
initial pending flag is on, the attention 
routine turns it off and schedules the 
local 3270 second- level attention routine 
(IGG019PG) by obtaining the IBB address 
from the UCB and the IQE address from 
the IBB, placing the address of the UCB 
for the device that caused the attention 
interruption into the IQEPARAM field of 
the IQE, and passing control to the 
asynchronous exit effector stage 2. When 
control returns to it, the attention 
routine returns control to IOS, 



For the logic flow of the local 3270 
first-level attention routine (IECTATEN) , 
see Chart C2. 



If the BLNs are different, the attention 
routine finds the IOE for the device that 
caused the attention interruption, using 
the control block link field, the DEBDCBAD 
field, and the product of the device index 
(in the UCE for the device that caused 
the attention interruption) and the 
CCEEIOEX field and the DCBIOBAD field. 
The attention routine copies the channel 
program area and the IOBECEFT, IOBFLAG1, 
and I0BE1AG2 fields from the initialized 
IOB into the IOB for the device that 
caused the attention interruption and, 
passing the address cf the newly initalized 
IOE, invokes EXCP (SVC 0) to start the 
Read Intitial operation. 

When control returns from EXCP, the 
attention routine zeros the initialized 
BLN field (in the UCB that has a device 
index of one) , places the BLN of the 
device that caused the attention 
interruption into the DECPCIPT field in 
the DECB, and returns ccntrcl to the 
a synchronous exit effector. 

For the logic flow of the local 3270 
second-level attention rou-tine (IGG019PG), 
see Chart C3. 



local 3270 Sec ond-Lev e l Att e ntio n 
Routine (IGG 019PG ) 

The local 3270 second-level attention 
routine (IGG019PG) is an asynchronous 
routine that is scheduled (through the 
asynchronous exit effector) by the local 
3270 first-level attention routine 
(IECTATEN) by the local 3270 BTAM SVC 
routine (IECTSVC) to start a pending Bead 
Initial operation. The seccnd-level 
attention routine resides in SYS1.SVCLIB; 
it is loaded into the problem program f s 
partition or region by the local 3270 
BTAM Open executor (IGG0194Q) . 

The attention routine finds the 
initialized IOB, using the control block 
link field (in the UCB that has a device 
index of one) , the DEBDCBAD field in the 
DEB, and the product of the initialized 
BIN field (in the UCE that has a device 
index of one) and the DCBEIOBX field in 
the CCE and the DCBIOBAD field in the 
DCE. If the RLN of the device that caused 
the attention interruption (given in the 
device index field in the UCB for that 
device) is the same as the BLN of the 
initialized IOB (given in the initialized 
BLN field in the UCB that has a device 
index of one) , the attention routine, 
passing the address of the initialized 
IOB, invokes EXCP (SVCO) to start the 
Read Initial operation. 



local 3270 BTAM SVC Routin e (IECTSVC) 

The local 3270 BTAM SVC routine (IECTSVC) 
checks and sets attention handling flags 
in the UCBs for local 3270 devices. The 
SVC routine, which is resident in the 
nucleus, has five entry points 
corresponding to five attention handling 
f urctiens: 

• IECTRDIL - Queue a Bead Initial 
reguest if no outstanding attention 
interruption exists for the line 
qroup. 

• IECTATBL - Reset the attention flag 
for a device and update the attention 
count for the line group. 

• IECTCHSL - Set the skip flag for 
a device in order to inhibit Bead 
Initial operations. 

• IECTCHAL - Beset the skip flag for 
a device in order to permit Bead 
Initial operations- 

• IECTRSTL - Degueue a Read Initial 
reguest. 

The SVC routine is irveked by means of 
SVC 116; a routing cede determines which 
of the five entry points receives control. 

IECTRDIL Entry Point : The SVC routine 
is entered at IECTRDIL from the BTAM 
Read/Write routine (IGG019MA) during 
processing of a Read Initial reguest. 
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(The Bead/Write routine uses IECTRDTI, 
an internal macro instruction that 
determines the address of the OCB for 
the device and invokes SVC 116 with a 
jccuting code of zero.) If the address 
cf an invalid UCB is received, the SVC 
routine returns control to the Bead/Write 
routine with a return code cf X'OS 1 . 
If at least one attention interruption 
is outstanding (that is, the attention 
count field in the UCB that has a device 
index cf cne is greater than zero) , the 
SVC routine returns control to the 
Read/Write routine (thorugh the SVC Exit 
routine) with a return code of X^O 1 . 
If no attention interruption is 
outstanding, the SVC routine queues the 
Bead Initial reguest by setting the read 
initial pending flag (bit 5) in the control 
byte in the UCB that has a device index 
cf one. The SVC routine places the device 
index from the UCB for the device specified 
in the Read Initial reguest into the 
initialized RLN field in the UCB that 
has a device index of one. The SVC routine 
returns control to the Read/Write routine 
(through the SVC Exit routine) with a 
return code of X'OiP, 

IECTATFL Entry Point : The SVC routine 
is entered at IECTATBL from the BTAM 
Read/Write routine during processing of 
any Read or Write reguest. (The Read/Write 
routine uses IECTATNR, an internal macro 
instruction that invckes SVC 116 with 
a routing code of one.) If the address 
cf a UCB that is invalid or that is not 
for a local 3270 device is received, the 
SVC routine returns control to the 
Read/Write routine with a return code 
cf X f 04 f . If the attention flag (bit 
7 in the control byte) in the UCB for 
th€ device specified in the Read or Write 
reguest is off, the SVC routine returns 
control to the Read/Write routine (through 
the SVC Exit routine) with a normal return 
code (X , 00 , )« If the attention flag is 
on, the SVC routine turns it off. If 
the skip flag (bit 6 in the control byte) 
in the UCB for the device specified in 
the Read or Write request is on, the SVC 
routine returns control with a normal 
return code. If the skip flag is off, 
the SVC routine subtracts one from the 
attention count field in the UCB that 
has a device index of one and returns 
control to the Read/Write routine (through 
the SVC Exit routine) with a normal return 
code. 



IECTCHSL Entry Po i nt : The SVC routine 
is entered at IECTCHSL from the expansion 
cf the CHGNTRY macro instruction when 
the SKIP operand is specified. (The 
expansion invokes SVC 116 with a routing 
code of two.) If the address cf a UCB 



that is invalid or that is not for a local 
3270 device is received, the SVC routine 
returns control to the macrc instruction 
expansion with a return code of X'08 f . 
If tihe skip flag in the UCB for the device 
specified in the skip reguest is on, the 
SVC routine returns control to the macro 
instruction expansion (through the SVC 
Exit routine) with a normal return code 
(X'OO 1 ). If the skip flag is off, the 
SVC routine turns it on. If the attention 
flag in the UCB is off, the SVC routine 
returns control with a normal return code. 
If the attention flag is on, the SVC 
routine subtracts one frcm the attention 
cotnt field in the UCB that has a device 
index of one and returns control to the 
CHGNTRY macro instruction expansion 
(through the SVC Exit routine) with a 
normal return code. 

IICTCHAL Entry Point: The SVC routine 
is entered at IECTCHAL from the expansion 
cf the CHGNTRY macro instruction when 
the ACTIVATE operand is specified. (The 
expansion invokes SVC 116 with a routing 
cede of three.) If the address of a UCB 
that is invalid or that is not for a local 
3270 device is received, the SVC routine 
returns control to the macro instruction 
expansion with a return code of X'OS 1 . 
If the skip flag in the UCB for the device 
specified in the activate reguest is off, 
the SVC routine returns control to the 
macro instruction expansion (through the 
SVC Exit routine) with a normal return 
code (X^O 1 )- If the skip flag is on, 
the SVC routine turns it off. If the 
attention flag in the UCB is off, the 
SVC routine returns control with a normal 
return code. If the attention flag is 
en and the read initial pending flag in 
the UCE that has a device index of cne 
is off, the SVC routine adds one to the 
attention count in the UCB that has a 
device index of one and returns control 
with a normal return code. If the read 
initial pending flag is on, the SVC routine 
turns it off and schedules the local 3270 
second-*level attention routine (IGG019PG) 
by obtaining the IRB address from the 
UCB and the IQE address from the IRB, 
placing the address cf the UCB for the 
device specified in the activate reguest 
into the IQEPARAM field of the IQE, and 
passing control to the asynchronous exit 
effector stage 2. When control returns 
to it, the SVC routine returns control 
to the CHGNTRY macro instruction expansion 
(through the SVC Exit routine) with a 
normal return code. 

IECTRSTL Entry Point : The SVC routine 
is entered at IECTRSiTL from the expansion 
of the RESETPL macro instruction when 
a local 3270 device is specified. (The 
expansion invokes SVC 116 with a routing 
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code of four-) If an invalid address 
or the address of an invalid UCB is 
received, the SVC routine returns control 
to the macro instruction expansion with 
a return code of X f 0C. If the address 
of a UCB that is not for a local 3270 
device is received, the SVC routine returns 
control with a return code of X'08 1 . 
If tiie Read Initial operation is in 
progress (that is, the read initial pending 
flag in the UCB that has a device index 
cf one is off) , the SVC routine returns 
control to the macro instruction expansion 
(through the SVC Exit routine) with a 
return code of X f 04'. If the Read Initial 
request is queued (that is, the read 
initial pending flag is on) , the SVC 
routine turns the read initial pending 
flag off and passes control to the Post 
routine to post (with a completion code 
cf X 1 ^ 1 ) the ECB associated with the 
queued Bead Initial request. When control 
returns tc it, the SVC routine returns 
control to the BESETPL macro instruction 
expansion (through the SVC Exit routine) 
with a return code of X^O 1 . 

For the logic flow of th€ local 3270 
ETAM SVC routine (IECTSVC) , see Charts 
C4, C5, and C6. 

Error Recovery Procedures 



The Error Recovery Procedures (ERP) 
routines are a composite set of routines 
designed to diagnose and recover, if 
possible, from all errors occurring during 
telecommunication operations. The error 
routines perform the following basic 
functions: 

1. Automatic retry of all errors not 
involving data transfer. 

2. Statistical recordinq of temporary and 
permanent unit check errors. 

3. Error messages to the operator console 
for all permanent errors. 

In addition, the following optional 
features can be included and performed by 
ERP. 

1. If, in the DCE macro, the LERB operand 
specifies the address of the line 
error recording block (LERB) and the 
EROPT operand specifies C, (with any 
of the possible valid combinations) , 
and if the LERB macro instruction is 
coded, ERP will maintain a count of 
all data check, timeout, and 
intervention-required errors, and a 
count of transmissions on the line. 

2. If EROPT=w (with any of the possible 
valid combinations) is coded in the 



DCB macro instruction, EFP will retry 
fcrite operations for write errors that 
occurred during text transfer. This 
parameter, W, is valid only for 
start-stop terminals ; it is ignored 
for BSC stations as BSC Write 
operations are always retried. (Write 
operations are not retried, however, 
if dynamic buffering is used.) 

3. If EROPT=R (with any of the possible 
valid combinations) is coded in the 
DCB macro instruction, ERP will retry 
Read operations for read errors that 
occurred during text transfer. This 
parameter, R, is valid for certain 
start-stop terminals; it is ignored 
for BSC stations as BSC Read Text 
operations are always retried- (Read 
operations are not retried, however, 
if dynamic buffering is in use.) 

The Read and Write retries will not be 
performed for devices not capable of 
accepting them. See the DCBERROP field in 
Table 1 (Appendix B) for the types of 
stations for which retries can be 
performed. 

Consisting of 27 modules, ERP operates 
in the nucleus error transient area with a 
supervisor protection key. The routines 
are entered from BTAM through IOS, and are 
always entered through the Control module 
(IGE0004A or IGE0004C) . The other modules 
are called as needed for error checking and 
error recovering. 

The error recovery control module sets 
up the linkage for subsequent loads of BTAM 
error modules. It then determines if entry 
is due to an initial error (i.e., one that 
occurred in a user-program Read or Write 
operation) or as the result of an ERP 
channel program execution. If it is an 
initial error, the error flags in IOB are 
set on to indicate that ERP is in control. 
By checking the condition code, the sense 
bytes, and the status bytes in the CSW, ERP 
determines the type of initial errors 
encountered and links to the proper error 
recovery routine. 

If ERP was previously in control upon 
entry to the control module, it checks to 
determine if an error retry was attempted. 
If it was, ERP checks to see if the error 
was recovered. If there is still an error 
(it may possibly be a different type of 
error on the same line), the control module 
determines the type of error and links to 
the prooer routine via the communications 
vector table (CVT) XCTL routine. If the 
error retry count has been reached, and 
statistical data recording is required, ERP 
exits to the Statistical update routine 
(part of the resident supervisor) which 
updates the Outboard Recorder (OBR) before 
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going to the supervisor Post routine to 
post the operation complete with error 
(X'^IM, Otherwise, if the error was 
recovered* or the retry count was not 
reached, ERP checks to see if statistical 
recording is required. If the error was 
recovered,, the ERP-in-control flags in the 
IOB are turned off and ERP exits to update 
the statistic table before going to 
supervisor Post to post the event complete 
without error (X^F 1 ). If no statistical 
recording is required, ERP simply goes to 
supervisor Post to post the event complete 
(X f 7F"). If the retry count was not 
reached and an error occurred, ERP checks 
for the type of error encountered and then 
links to the proper ERP module by the CVT 
XCTL routine. 



status (SOH % B) message into a T-type 
record. The Error Post routine receives 
control from the BSC EBP control routine 
(IGE004C) . The Error Post routine passes 
control to the TP recorder (IGE0625F) 
to have the T-type record recorded in 
SYS1.LCGBEC. 

See Charts E0-E9, F0-F9, G0-G9B, and 
C0A-J2C for the logic flow cf the EBP 
nodules. 

For a description of the EBP rouitnes 
for the local 3270 display system, see 
Appendix L. 

Buffer Routine (IGG019MS) 



The remote 3270 Error Post routine 
(IGE0704B) formats the address and error 
information from a remote 3270 error 



When the user specifies a buffer pool, he 
may wish to use the REQBUF and RELBUF macro 
instruction to obtain from the pool, or 
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restore to the pool, one or more buffers. 
The Buffer routine performs these 
functions, when entered from REQBUF or 
RELBUF via SVC 58. (See Chart 06 for the 
logic flow of the Buffer routine module.) 

When dynamic buffering is being used, 
the Buffer routine is activated 
asynchronously by the channel end appendage 
(IGG019MB) and the PCI appendage (IGG019MC) 
to provide management of buffers for the 
channel program already started. The 
routine is always resident and disabled. 

The address of the buffer pool is 
located in the DCB; the address of the 
Buffer routine is in the DEB following the 
table of UCB addresses. The Buffer routine 
manages a last- in first-out (LIFO) queue of 
buffers for each buffer pool through use of 
the buffer control block (BCB). The buffer 
control block is an 8-byte area in storage 
whose address is contained in the DCB 
(DCBBUFCB field). The initialization and 
location of the BCB is dependent on the 
choice of buffering techniques. Refer to 
the publication IBM System/ 3 60. Operating 
System: Basic Telecommunications Access 
Method , GC30-2004. 

The buffer control block contains the 
address of the first available buffer, the 
count of available buffers, and the length 
of each buffer (all are the same length) . 
The length includes the fullword chaining 
address of the next available buffer. See 
Figure 6. 

Buffer Control Block (BCB) 
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Figure 6. Buffer Control Block 

The address of the Buffer routine is 
placed in the DEB following the table of 



UCBs. Following the address is a pointer 
to the request queue and then a pointer to 
the last entry in the request queue. 
(These requests are the IOBs for the 
lines.) These request elements are 
requests for buffers for Read operations 
and are placed in the queue only by the PCI 
appendage. Each element is linked* via the 
Read CCW requiring the buffer address with 
a pointer in the data address field, to the 
next CCW requiring a buffer. (See Figure 
7.) 

Elements are removed from the queue by 
the Buffer routine when buffers are 
returned to the buffer pool. 
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Figure 7. Buffer Request Queue 



Change Entry Routine (IECTCHGN) 



The Change Entry routine is entered via the 
expansion of a CHGNTRY macro instruction 
specifying SSALST, SSAWLST, AUTOLST* or 
AUTOWLST. The macro expansion includes a 
V-type address constant that generates an 
automatic call for the routine when the 
problem program is link-edited. The 
routine performs the function of physically 
restructuring the polling list in order to 
cause an entry to be skipped or 
reactivated. 

If SKIP is specified as the action 
operand, the entry corresponding to the 
index value specified in the position 
operand will be removed from the list of 
active entries, the active entries which 
followed it will be moved up an amount 
equal to the entry width, the skipped entry 
will be placed in the position previously 
occupied by the last active entry* and the 
number of active entries will be 
decremented. 
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If ACTIVATE is specified as the action 
operand, the entry corresponding to the 
index value specified in the position 
operand will be removed from the list of 
inactive (skipped) entries. All inactive 
entries which precede it in the list and 
all active entries of greater index value 
will he moved down an amount equal to the 
entry width. The activated entry will be 
placed in the slot previously occupied by 
the active entry of next greater index 
value or by the first inactive entry. The 
number of active entries will be 
incremented. 

Issuing a CHGNTRY macro causes no action 
to be performed if the list is currently in 
use by a Read operation, if the specified 
entry is already active (for ACTIVATE) or 
inactive (for SKIP), or if the operand 
specifying the position of the entry is too 
large (i.e., no such entry exists). 

Return Codes 

A return code in register 15 indicates the 

result of issuing the CHGNTRY macro. 



Code Meaning 

X f 00 f The requested action was 

performed or was not needed (for 
SKIP, the entry was already 
skipped; for ACTIVATE, the entry 
was already active) . (This code 
is also returned if the operand 
specifying the position of the 
entry is 0.) 

X'Ot** The requested action was not 

performed, because the list was 
in use. 

X f 08 f The requested action was not 

performed, because the operand 
specifying the position of the 
entry was too large. 

(See Charts Kl and K2 for logic flow of 
IECTCHGN) . 



Edit Routine (IECTEDIT) 



The Edit routine is entered via the 
expansion of a TPEDIT macro instruction 
issued in the user program. The purpose of 
the routine is to edit data received from 
an IBM 50 Magnetic Data Incriber attached 
to an IBM 2772 Multipurpose Control Unit. 
The routine scans the input area into which 



IBM 50 MDI data is received, for special 
MDI control codes, such as LZ (left zero 
fill), LZS (left zero start), DUP 
(duplicate), and CAN (cancel). Upon 
encountering one of these codes, the 
routine performs the appropriate function 
such as duplicating specified characters 
from the previous record, deleting 
cancelled records, and performing left- zero 
justification. Information in a parameter 
list passed to the routine from the TPEDIT 
macro governs the execution of certain of 
the functions. At user f s option, records 
found to be error will be passed to the 
user-specified error exit routine; the 
record so passed is preceded by an error 
description word that conveys the nature of 
the error. 



Line Error Print Routine (IECTLERP) 



The Line Error Print routine is entered via 
the expansion of a LERPRT macro instruction 
issued in a BTAM problem program. The 
macro expansion includes a V-type address 
constant which generates an automatic call 
for the routine when the problem program is 
link-edited. The routine will set up to 
print line error counts for data check, 
intervention required, non-text timeout 
errors, and the number of transmissions for 
the lines specified in the LERPRT macro 
instruction or for all lines in the line 
group. These counts are obtained from the 
line error recording block (LERB) # the 
format of which is shown in Figure 8,. 

The routine initializes the pointers 
before checking for a line group print. If 
counts for an entire line group are to be 
printed, the routine determines the number 
of lines from the data extent block field 
DEBNMEXT. Since the pointers are 
initialized to the line prior to the line 
to be printed, the routine now picks up the 
line to be printed, updates all the 
accumulative counters, and places the 
counts in the generated message before 
exiting to Write to Operator (WTO) to print 
the message on the system console. The 
message area and error counters are 
cleared. If messages are to be printed for 
all lines in the group, the routine checks 
to see if all lines have been printed by 
looping back to step to the next line in 
the group. When all messages for lines 
have been printed, the routine returns to 
the problem program. (See Chart F7 for 
logic flow of IECTLERP),. 
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Figure 8. Format of Line Error Recording Block (LERB) 



Line Open Routine (IECTLOPN) 

The Line Open routine is entered via 
expansion of the LOPEN macro instruction 
issued in a BTAM problem program to attempt 
to correct an error which occurred at Open 
time or to reestablish data set (modem) 
synchronism for a line using an IBM 3977 
Model 2 modem. The macro expansion 
includes a V-type address constant which 
generates an automatic call for the routine 
when the problem program is link edited. 
The error is indicated by a return code of 
X'lU' in register 15 after the problem 
program has issued a READ or WRITE macro 
instruction. 

The routine builds the channel program 
needed to correct the error condition, then 
issues an EXCP to execute that program. 

The routine first verifies that the 
line group data set has been opened, the 
user-specified relative line number is 
valid, the IOB is not busy, and the 
transmission control unit is operational. 
If any of these conditions is not true, the 
routine returns to the user program with 
the appropriate return code (X'10', X'0C f , 
X f 08", or X , 0U > respectively) in register 
15* If OLTEP is using the device, the 
routine returns control to the problem 
program with a return code cf X f 14' in 
register 15. Before checking for an 
op€rational TCU, the routine checks whether 
the device specified in the LOFEN macro 
instruction is a local 3270 device. If 
it is, the routine turns on the busy flag 
(bit 1 in IOBINCAM) , sets up an Erase/Write 
command to unlock the keyboard and reset 
the modified data tags, and starts the 
channel program by issuing EXCP. If the 
device is not a local 3270 device, the 
routine checks whether the TCU is 
operational. 



The routine then sets the busy flag 
(bit 1 of IOBINCAM) and sets up a Disable 
command. If the TCU is a 2702, a Set 
Address (SAD) coirirand is set up following 
the Disable; if the TCU is a 2701 or 2703, 
no SAD command is set up. Then, if the TCU 
is a 2701 or 2703 with a BSC adapter, a Set 
Mode command is set up following the 
Disable or SAD command; otherwise., no Set 
Mode command is set up. The routine then, 
via EXCP, starts the channel program just 
built. 

If the channel program is not posted 
complete in the ECB within about four 
seconds, the routine sets the SAD/Enable 
error flag in IOBINCAM and returns to the 
user program with a return code of X f 0U f in 
register 15. If the channel program is 
posted complete, the routine determines if 
that completion was normal (X'7F f in ECB). 
If so, the routine turns off the SAD/Enable 
error and busy flags in IOBINCAM an3 
returns to the user program. If the 
completion was not normal, the routine 
turns on the SAD/Enable error flag and 
returns to the user program with a return 
code of X tt 04*. 

See Charts 07 for the logic flow of 
IECTLOPN. 



Translate Routi ne ( IECTTRNS ) 



The Translate routine is entered from the 
expansion of the TRNSLATE macro instruction 
issued by a BTAM problem program. The 
macro expansion includes a V-type address 
constant that generates an automatic call 
for the routine when the problem program is 
link edited. The routine checks first for 
dynamic buffering. If dynamic buffering 
was not specified, the routine checks for a 
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count greater than 256 in which case it 
translates 256 bytes and loops tack to 
check again. When the count is less than 
256 , IECTTRNS translates the remaining 
number of bytes and exits. 



When dynamic buffering is specified and 
the count is given , the count is adjusted 
for the link field. The routine translates 
256 bytes at a time until the count is less 
than 256. After translating the buffer, 
the routine checks for last buffer. If 
this is the last buffer, the routine exits; 
otherwise, it loads the address of the next 
buffer, loads the count from the DCB, 
adjusts the count for the link field, and 
begins the 256 byte translating loop. 



If dynamic buffering was specified and 
the count was not given, the routine gets 
the count from the DCE and then performs 
the same as if the count had been specified 
with dynamic buffering. (See Chart 08 for 
logic flow of IECTTRNS.) 



On-Line Testing 



On-line testing is an optional ETAM 
facility that permits the user to verify 
proper operation of terminals and of the 
communication lines that link them to the 
computer, and to aid in diagnosing line or 
terminal troubles. On-line testing centers 
around transmission of predefined standard 
test messages, whose formats depend on the 
purpose of the test. 



The user requests transmission of test 
messages during normal BTAM operation, and 
only the communication lines and terminals 
he specifies are involved? data 
transmission proceeds as usual on other 
lines. Operation of the user's problem 
program is affected only to the extent of 
the line time required for test 
transmissions and of the CPU time required 
to process requests for tests. 



On-line testing is available only if the 
user codes T among the EROPT options in the 
DCB macro for the affected line group. 
This causes the on-line test control 
module, IGG019MR or IGG109PI, to be loaded 
at Open time. 



On-line testing is implemented somewhat 
differently for start-stop lines, for 
binary synchronous lines, and for local 
3270 devices, and the three types are 
therefore discussed separately. 



On-Line Testing for Start-Stop 
Communication Lines 



For start-stop communication lines, test 
requests may be initiated only at remote 
terminals. The tests requested may involve 
message switching, comparing of the 
contents of a test message to a stored 
pattern in main storage, sending a string 
of characters to a specified terminal, or 
checking the IBM SELECTRIC typing element 
mechanism of a terminal printer. 

Test request message formats always 
begin with a five-byte zoned decimal field 
containing 9 f s. Any such message received 
by a Read text command is recognized as a 
test request message by the channel end 
appendage (IGG019MB), which transfers 
control to the On-Line Test Control Module 
(IGG019MR) without posting the operation as 
complete in the DECB for the line. 
IGG019MR sets up and executes the channel 
program appropriate to the kind of terminal 
and line involved, and sends the requested 
test message. In generating the channel 
program, the module uses the SVC 66 module 
(IGC0006F) and the appropriate 
device-specific test module: IGC0106F (for 
1030), IGC0206F (for 1050), IGC0306F (for 
1060), IGC0406F (for 2740) , • IGC0906F and 
IGC0A06F (for 2741) , or IGC0506F and 
IGC0606F (for 2260/2848), or IGC0B06F (for 
2760). These are type 4 SVC routines that 
operate in the SVC transient area. 
IGC019MR is entered from the channel end 
appeandage each time channel end occurs 
during the on-line test, and upon 
determining that the test is completed, 
frees any main storage used by the channel 
program as a test message area, and 
restores the problem program Read Initial 
operation. 



On-Line Testing for Binary Synchronous 
Communication Lines 



On-Line tests for BSC lines may be 
requested by the central computer, by 
remote computers or terminals, or both, 
depending upon the type of test and the 
line and computer /terminal configuration. 
There are 34 types of tests, not all of 
which apply to all configurations. 

To request a test at a remote computer 
or terminal, the operator at that location 
enters a message, called a request-for-test 
(RFT) message, having a special format* To 
request a test at the central computer, the 
programmer codes an ONLTST macro 
instruction in his problem program at the 
point at which he wishes a test to be 
performed. The ONLTST macro generates the 
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proper RFT message and sends it to the 
remote computer or terminal the user 
specifies in the ONLTST macro. The format 
of the RFT message is the same whether it 
is sent by the central computer or is 
received by the central computer from a 
remote computer or terminal. 

Transmission of an RFT message is 
followed by one or more transmissions of 
test messages. The RFT message contains a 
field called the X field, by which the user 
codes the test type, from 00 to 3 4, to be 
performed. The test type governs the 
sequence of I/O operations comprising the 
test and determines the content of the test 
message. 



Type 00 : For this test type the RFT 
message is accomplished by user-specified 
text data. For RFT messages received from 
a 2770 or 2780 terminal the text data is 
part of the RFT message; for RFT messages 
received from other types of ESC stations 
or sent to any type of BSC station, the 
text data is sent as a separate test 
message. When the RfT message includes the 
text data, the text data is received only 
once, and the receiving computer sends a 
single acknowledgment in reply. When the 
text data is contained in a separate test 
message, the computer or terminal sending 
the RFT sends the test message the number 
of times specified in the Y field of the 
RFT message. The Y field may specify from 
1 to 99 transmissions. The receiving 
computer or terminal sends an 
acknowledgment after each message. 



Type 01 : For this test type the RFT 
message includes user-specified text data. 
The computer or terminal receiving the RFT 
message acknowledges it, sets up a test 
message containing the text data, and sends 
the test message the number of times 
specified in the Y field of the RFT 
message, from 1 to 99. The computer or 
terminal receiving the test messages sends 
an acknowledgment each time a message is 
received. Notice that in type 00 tests the 
computer or terminal that sends the RFT 
message also sends the test messages, and 
receives acknowledgments in reply, while in 
type 01 tests the computer or terminal that 
sends the RFT message receives test 
messages in reply. 

I Types 02-3 4; For these types of tests, 
test messages consist of BTAM-defined, 
rather than user-specified, text data. 
Otherwise, they are similar to type 01 
tests. When BTAM receives an RFT message 
it examines the X and Y fields, selects the 
test message designated by X and sends it 
the number of times specified by Y (from 1 
to 99). 



RFT message formats always begin with a 
two-byte field containing SOH %. Any such 
message received on a Read Initial or Read 
Connect operation or on a Read Continue 
operation after a general pell of a remote 
3270 display system or sent via 0NLTST 
macro is recognized as an RFT message 
by the channel end appendage, IGG019MB, 
which transfers control to the On-Line 
Test Control module (IGG019MR) without 
posting the operation as complete in the 
DECB for the line. IGG019MB sets up and 
executes the channel progran appropriate 
to the kind of transmission code (EBCDIC, 
OSASCII, or TRANSC0DE) and kind of test 
requested. IGG019MR uses the SVC 66 
module (IGC0006F) and the On-Line Test 
Control (BSC) module (IGC0D06F) to set 
up the kind of channel program needed, 
and (via XCTL from IGC0006F) uses module 
IGC0706F, IGC0806F, IGC0E06F, IGC1406F, 
IGCOF06F, IGC1306F, IGC1006F, or IGC1106F 
if BTAM-defined test messages are to be 
sent. These modules provide to the channel 
program the requested kind of test message, 
and start the channel program. IGG019MR 
is entered from the channel end appendage 
each time channel end occurs during the 
on-line test. Each time it is entered, 
it determines whether the test has been 
completed (i.e., all requested test 
messages have been sent) , restarts the 
channel program as necessary for each 
test message transmission, performs error 
checking, and accumulates error counts. 
When all test messages for a given on- 
line test have been sent, IGG019MR writes 
to the operator of the central computer 
a message containing the error counts 
for the operation and restores the problem 
program Read Initial of Read Connect 
operation. 

If the RFT message was received on 
a Read Continue operation, the operation 
is posted complete, and an EOT is placed 
into the first byte of the input buffer. 

Hot e; lor the logic flow of on-line test 
modules for the remote 3270 display system, 
see charts D1 through D5, TC and T01, 
and T10 through T15. 



When the user program initiates an 
on-line test, test mode is not entered 
until 3TAM receives an ACK-0 from the 
remote station. If after seven retries the 
ACK-0 has not been received, the test is 
aborted, and the user-program Read Initial 
or Read Connect operation is restarted. 



During the test, up to 25 consecutive 
WACK responses will be accented by BTAM 
from the remote station before the test is 
aborted. 
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Cn- Lin e Testi ng for Lo cal 3270 Devices 

On-line tests for JLocal 3270 devices are 
requested frcm the local 3270 display 
station by entering a reguest-for-test 
(RFT) message. Transmission of an RFT 
message is followed fcy one cr more 
transmissions of a test message. The 
BFT message contains an X field in which 
the display station operator codes the 
test type, from 23 to 28 r to be performed. 
The test type governs the sequence of 
I/C operations making up the test and 
determines the content of the test message. 

BFT messages received on a Read Initial 
operation from a local 3270 display station 
are recognized by the local 3270 channel 
end/abnormal end appendage (IGG019PA) . 
Ey means of the asynchronous exit effector, 
the appendage schedules the local on-line 
test control (IGG019PI) without posting 
the operation complete in the DECB. 
IGG019PI sets up the type of test 
reguested, handles I/O interruptions 
during the test, and ends the test. By 
means cf SVC 66, IGG019PI passes control 
to the start-stop on-line test control 
(IGC0006F) , which transfers control to 
the local 32 70 on-line test control 
(IGC1206F). IGC1206F sets up the channel 
program for the type of test requested 
and passes control to a 3270 EBCDIC test 
module (IGC0E06F, IGC1406F, or IGC1306F) 
to provide the channel program with the 
test message for the requested type of 
test and to start the channel program. 
IGG019PI is entered from the local 3270 
channel end/abnormal end appendage each 
time channel end occurs during on-line 
test. Each time it is entered, it 
determines whether the test has been 
completed, restarts the channel program 
as necessary for each test message 
transmission, and retries (three times) 
tests with error ending status before 
terminating test. When all test messages 
for a given on-line test have been sent, 
IGG019PI restarts the Bead Initial 
operation. 

For the logic flow of on-line test 
modules for the local 3270 display system , 
see Charts D5A and D5B, TO and T02, and 
T10 through T13. 



REQBUF/RELBUF (SVC 58) Routine (IGC058) 



information from the Buffer routine to the 
problem program. (See Chart 09 for the 
logic flow. ) 



BTAM Close Executor (IGG0203M) 



The Close executor logically detaches a 
communication line group from the system. 
(See Chart 10 for the logic flow.) The 
routine performs the following: 

• Halts any outstanding enable commands. 

• Stops I/O activity on the lines. 

• Disables the lines. 

• Frees the storage obtained by open for 
input/output blocks. 

• For a line group of local 3270 
devices, frees the storage obtained 
by the local 3270 Open executor for 
the interruption request block and 
interruption queue element and clears 
the fields in the graphics devices 
segment of the UCBs. 

• Reinitializes DCB fields. 

• Frees the storage occupied by the 
buffer pool, if a buffer pool was 
obtained by the Open executor. 

After the Close executor has been 
executed for each of the DCBs in the 
parameter list of the CLOSF macro, it 
returns control to the system Close routine 
which completes the processing, deletes the 
BTAM routines and appendages, frees the 
storage occupied by the data extent block 
(DEB) , and completes the reinitialization 
of DCE fields. 



BTAM CONTROL INFORMATION FOR CHANNEL 
PROGRAM GENERATION 

This section describes the form and 
content of the BTAM channel command word 
(CCw) and the control fields used for 
channel program generation. P knowledge of 
these control fields is essential to 
understanding the channel program 
discussion in the following chapters. 

BTAM Channel Command Word 

The format of the BTAM channel command 
word is as follows: 



SVC 58 provides access to the Buffer 
routine from either the REQ^BUF or RT^LBUF 
macro. A type I SVC (resident and 
disabled), the routine is a part of the 
nucleus of all systems using BTAM. It 
calculates the address of the buffer 
routine, releases control to it, and oasses 



Command Code 


Data Address 


7 8 




31 


Flags 


000 


TP Op Code 


Count 



36 37 39 40 



63 



36 



The CCW used within BTAM is identical to 
that used throughout System/360 except for 
the addition of a teleprocessing operation 
code (TP-Op Code) in the sixth byte (bits 
40 through 47). This byte, which is unused 
in other environments, has no effect upon 
channel operations. Bit 40 is set to one 
in the last CCW created dynamically for a 
channel program. Bit 41 is reserved for 
use with dynamic buffering. The use of 
bits 42 through 47 is described in the 
chapter, BTAM Channel Programs General. 



code X'OC" to indicate that the requested 
operation is not valid for the type of 
device involved. 

Where more than one operation tyoe 
appears within an offset byte, only one 
type is valid for the device represented by 
the device I/O module. In Figure 6, for 
example, the offset values and operation 
types are those applicable to the IBM 1050 
on a nonswitched line. The shaded areas in 
the table of offsets indicate the operation 
types and bytes that do not apply to the 
IBM 1050 on a nonswitched line. 



Device I/O Modules 



A device I/O module contains the control 
information for the generation of channel 
programs for a given type of remote or 
local station cr line configuration. 
There is a spearate device I/O module 
for each type of start-stop terminal 
(e.g., IBM 1030, 1050, 2740 with Dial- 
up, 2740 with Station Control, ATST 83B3) 
and each type of BSC line configuration: 
nonswitched point-to-point, nonswitched 
multipoint, and switched point-to-point. 
The module is loaded into main storage 
by the BTAM Open executor. 

There is a separate device I/O module 
for the local 3270 display system; it 
is loaded into main storage by the local 
3270 BTAM Open executor. 

The device I/O modules are listed below 
and in Appendix I. 

Figure 9 shows the format of the device 
I/O module;- the format is the same 
regardless of the type of device for which 
the module is used. The device I/O module 
has four parts: 

• A 32-byte table of offsets. 

• The channel program offsets for the 
Read and Write operations. 

• The channel command words for the 
channel pro-grams. 

• A table of special characters 
(start-stop only) . 

The 32-byte table of offsets is at the 
beginning of the device I/O module. Each 
byte contains the binary offset factor used 
to access the channel program offsets for 
an I/O operation. If the operation is 
invalid for the type of device represented 
by the module, the byte contains an offset 
value of all ones (hexadecimal FF) . If one 
of these invalid bytes is accessed, control 
is immediately returned to the calling 
routine, with register 15 containing return 



Byte 18 (hex) contains the offset to the 
channel command words. 



Read/Write Operation Types 



An operation type is associated with each 
byte in the table of offsets; the position 
of the byte corresponds to the value of the 
type code in DECTYPE field of the DECB. 



Byte 
(hex) 


1 
2 
3 
4 
5 
6 
7 



9 

A 



B 
C 



10 

11 

12 



Operation Type 

Write Break (TB) 
Read Initial (TI) 
Write Initial (TI) 
Read Continue (TT) 
Write Continue (TT) 
Read Conversational (TV) 
Write Conversational (TV) 
Read Repeat (TP) 
Read Continue with ID 
Exchange (TE) 

Write Positive Acknowledgment 
(TA) 

Read Skip (TS) 

Write Negative Acknowledgment 
(TN) 

Write Reset (TR) 
Write Disconnect (TN) (TWX) 
Read Buffer (TB) 
Write at Line Address (TL) 
Write Initial Optical (TIO) 
Write Initial Transparent 
Block (TIE) 

Write Initial Conversational 
(TIV) 

Read Continue with Leading 
Acknowledgment (TTA) 
Write Erase (TS) 
Write Invitational Optical 
(TCO) 

Write Continue Transparent 
Block (TTE) 

Write Continue Conversational 
(TTV) 

Write Disconnect (TD) (BSC) 
Read Connect (TO 
Read Modified (TM) (Local 3270) 
Write initial Transparent 
(TIX) 
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FF 


20 
Read Initial 


27 
Write Initial 


30 
Read Continue 


\ 




Wftf* fefttft 




4 


35 
Write Continue 


FF 


FF 


3A 
Read Repeat 






Jfe^Spj/g^Jic^ 


Wffcte Cam»w8atfo»iijf *"•' 


" '^Mljgl )l3tttjflj ytffi. %b^r>^ ;•; 




8 


3F 
Write Positive Acknowledgment 


41 
Read Skip 


43 
Write Negative Acknowledgment 


FF 






-W*%w*" 


^Mi^i^^^^^^^^i 






FF 


FF 


FF 


FF 




C 


Wife tifre £&&**$ 

W*n WW Oftfrci ; 










WtSs Swiftrwfe ®mv*ptittUtmt 


> 




FF 


FF 


FF 


FF 


10 


Writ* Mtfej trti»^«r«n* 
. Writ* C<Mftw*r«ii^«Wf J *Pp*M 






Wfc'$&*aem& 


. $fc$p*n$|) 


" ; ip^^^^^M^^^^^ 




14 


FF 


FF 


FF 


FF 






Wtf& Cwt'itsv* famwfmi& 


&#«3 iwiitiy 


W«*fc btqwtty- 


fe^fftajdssaf-vy/W^, ikaphfo* v 




18 


45 
OFFSET TO CCWs 


FF 


FF 


FF 






Wi& fomnl fafrt*? 


Wtf te Vsfetj* M^'tlww^J'"' 1 ' 1111 "" 1 


" '&*(»»$ 




1C 


FF 


FF 


FF 


FF 






.. ' $**&&§.. 


$Mj$fe %l^^^m^. ' tran^y" ; : y:;('. 


j^p$^|- :'• ^g I-;:;i;^: J. M;?8S 


W-rTfe Cfffitfw* &«****$< Twftw^ t ^ 


20 


Read Initial Channel Program Offsets 




28 
or 


Write initial Channel Program Offsets 




30 
34 
38 


Read Continue Channel Program Offsets 


> 


Write Continue Channel Program Offsets 


3C 


Read Repeat Channel Program Offsets 


Write Positive Acknowledgment. . 




40 


...Channel Program Offsets 


Read Skip Channel Program Offsets 


Write Negative Acknowledgment. 




44 


...Channel Program Offsets 


Channel Command Words 
(eight bytes each) 












+n: 


r 


Special Characters 


-r 





Figure 9. Format of Device I/O Module (showing nonswitched 1050 Offsets) 



13 



14 

15 
16 
17 

18 
19 



1A 

IB 
1C 

ID 

IE 
IF 



Write Conversational Optical 
(TVO) 

Write Unprotected Erase 
(TUS) (Local 3270) 
Bead Continue with Leading 
Graphics (TTL) 
Read Buffer from Position 
(TBP) (Local 3270) 
Write Continue Transparent 
(TTX) 

Read Inquiry (TQ) 
Write Inquiry (TQ) 
Read Repeat with Leading 
Graphics (TPL) 
Reserved 

Read Initial Inquiry (TIQ) 
Read Modified frcm Position 
(TMP) (Local 3270) 
Write Wait Before Transmit 
(TW) 

Read Interrupt (TRV) 
Write Connect (TO 
Write Initial Conversational 
Transparent (TIVX) 
Read Connect with Tone (TCW) 
Write Continue Conversational 
Transparent (TTVX) 



Thus, byte 4 in the table of offsets 
contains the appropriate offset value for 
any device for which the Write Continue 



operation is valid. (Otherwise , byte 4 
will contain a hexadecimal FF.) 

Note: Although the position of the offset 
byte for an operation type is the same for 
all types of stations or lines, the actual 
offset value contained in that byte is not 
the same for all types of stations or 
lines. The offset value is a functionof 
the number of bytes occupied by preceding 
channel program offsets , which varies 
depending on the device involved. 

All offset factors are calculated with 
respect to the first byte of the device I/O 
module. 

Following the table of offsets in the 
device I/O module are the model channel 
program offsets for the device; they are 
contiguous, beginning immediately after 
byte 32 of the table. 

Following the last channel command word 
in the start-stop device I/O module is the 
table of special characters for the device 
(e.g., EOT, N ). The field contains the 
actual hexadecimal representations of the 
character sequence. For BSC devices, the 
table of special characters is located in 
the BSC interface section of the DCB. 
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List of Device I/C Modules 

These are the BTAM device I/O module names; 
(they are also listed in Appendix I): 



(Auto Poll) 



Start-Stop Terminals: 

IBM 1030 

IBM 1030 (Auto Poll) 

IBM 1050 , Nonswitched 

IBM 1050, Nonswitched 

IBM 1050, Switched 

IBM 1060 

IBM 1060 (Auto Poll) 

IBM 2260 (Remote) 

IBM 2740, Basic 

IBM 2740, with Checking 

IBM 2740, with Station Control 

IBM 2740, with Station Control 

(Auto Poll) 
IBM 2740, with Station Control 

and Checking 
IBM 2740, with Station Control 

and Checking (Auto Poll) 
IBM 2740,, with Checking and 

2760 Attachment 
IBM 2740, Dial-up 
IBM 2740,, Dial-up, 
IBM 2740, Dial-up, 

Control 
IBM 2740, Dial-up, 

Control and Checking 
IBM 2740, Dial-up, with Checking 

and 2760 Attachment 
IBM 2741, Nonswitched 
IEM 2741, Switched 
ATST 83B3 
WU TWX 33/35 
WU 115A 
World Trade Telegraph Terminals 



BSC Stations: 

Nonswitched Point-to-Point 

(BSC1*) 
Switched Point- to- Point (BSC2 1 ) 
Nonswitched Multipoint (BSC3 1 ) 



with Checking 
with Transmit 

with Transmit 



IGG019MJ 
IGG019MK 
IGG019MD 
IGG019ME 
IGG019MF 
IGG019MI 
IGG019M4 
IGG019M3 
IGG019MT 
IGG019MO 
IGG019MZ 

IGG019M2 

IGG019MY 

IGG019M1 

IGG019PL 
IGG019MU 
IGG019MX 

IGG019MW 

IGG019MV 

IGG019PM 
IGG019PE 
IGG019PF 
IGG019ML 
IGG019MP 
IGG019MN 
IGG019PB 



executor when the device I/O modules are 
loaded, contains the address of each device 
I/O module in main storage. 



The format of the device I/O directory 
is shown as follows: 



- 4 byres- 



16 
entries 



Device Code 


Device I/O Module Address 




Device Code 


Device I/O Module Address 








Device Code 


Device I/O Module Address 


X'FF' 



IGG019M5 
IGG019M6 
IGG019PC 



Figure 10. Format of Device I/O Directory 



As each DCE is opened, the device I/O 
module for the corresponding type of 
station or line configuration is loaded 
into irain storage, unless the required 
module is already present. The address of 
the module is placed in the first available 
directory word, and an index value 
representing the position of the entry 
within the directory is placed in field 
DCBDEVTP of the DCB. The index value for 
the first directory entry is 0; for the 
second, 1, etc. 



Note: The value contained in DCBDEVTP is 
not a fixed code related to a particular 
type of station or line. 



Local Station: 

Local 3270 Display System IGG019PH 

Device I/O Directory 



The device I/O directory, contained within 
module IGG019MA and initialized by the Open 



Before the index value is placed into 
DCBDEVTP, the contents of that field are 
placed into the first byte of the directory 
entry. This data is a fixe^ code for each 
type of station or line, and represents 
optional features or modes of operation, as 
well as identifying the type of station or 
line. This device code is used by the Open 
routine in determining whether a given 
device I/O module is in main storaqe. 



*As specified in the UNIT operand of the 
IODEVICE macro instruction. 
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BTAM CHANNEL PROGRAMS — GENERAL 



characters provided in the DCB (for BSC 
operations) or the device I/O module 
(for start-stop operations). 



This chapter shows the command codes and 
TP-Op codes used in the channel command 
words composing BTAM channel programs. The 
following three chapters describe the 
channel programs generated by the 
Read/Write routine for each kind of BTAM 
BEAD and WBITE macro instruction. Channel 
programs for start-stop operations are 
arranged by type of terminal supported 
by BTAM; channel programs fcr BSC 
operations are arranged by kind of line 
configuration, and apply equally to all 
types of the BSC stations that may be 
used in that line configuration. The 
third chapter describes channel programs 
for the local 3270 display system. 



BTAM Channel Program Format 



• Response (or Respn) refers to the 
DECRESPN field of the DFCB. 

• List refers to the appropriate entry in 
the terminal list associated with the 
Read or Write operation. 



Flags refer to the flags turned on in the 
CCW: 

• CD Chain Data (bit 32). 

• CC Chain Command (bit 33) . 

• SLI Suppress length indicator (bit 34). 

• Skip Suppress data transfer (bit 35) . 

• PCI Program Controlled Interrupt (bit 
36). 



In the next two chapters, BTAM channel 
programs are represented graphically in 
this format: 



Operation 


Address 


Flags 


Tp-Op Code 


Count 













Operation is the type of operation 
performed by the command, along with the 
kind of information JDeing sent, for a Write 
operation, or the kind of information 
expected, for a Read operation. The 
operation type is represented in the CCW by 
the command code (bits 0-7). Upon 
completion of execution of a command § the 
command code appears in the DECCMCOD .field 
of the DECB associated with the Read or 
Write operation. Figure 11 gives the 
command code for each type of operation 
(including some not presently used in 
BTAM) . 

Address is the data address placed in the 
CCW (bits 16-31) prior to command 
execution. In this field, 

• Area refers to the data area (buffer) 
address specified in the DECAREA field 
of the DECB. 

• Table refers to the appropriate 
location in the table of special 



TP-Op Code is the code in bits 40-47 of the 
generated CCW. This code is inspected by 
the channel end/abnormal end appendage upon 
the occurrence of channel end and device 
end. 

Bits 42-47 of the code indicate the 
function preformed by the command; e.g., 
read response to addressing, write EOT 
sequence, or read text. 

Bits 40 and 41 are set independently of 
bits 42-47. Bit 40 is set to 1 in the last 
CCW of the channel program. The Read/Write 
routine when modifying the basic channel 
program to use dynamic buffering, sets to 1 
bit 41 of each of the CCWs effecting text 
transfer. 

Figure 12 shows the TP-Op codes 
currently used in BTAM commands. 
Operations applicable to a specific type or 
class of remote station are so indicated. 

Count is the value placed in CCW bits 4 8-63 
prior to command execution. 

• Length refers to the length of the data 
area (buffer) specified in the DECLNGTH 
field of the DECB. 

• List refers to the length of the 
appropriate character sequence (polling 
characters, dial digits, etc.) in the 
terminal list associated with the Read 
or Write operation. 
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r 




Code 




Command 


(Hex) 




Test I/O 


00 




Write 


01 




Read 


02 




I/O NOP 


03 




Sense 


04 




Diagnostic Write 


05 




(Auto Wrap) 






Prepare 


06 




Poll 


09 




Inhibit 


0A 




Break 


0D 




Search 


0E 




Diagnostic Read 


12 




Set Address 


13 




Set Address 1 


17 




Set Address 2 


IB 




Address Prepare 


IE 




Set Address 


IF 




Set Mode 


23 




Enable 


27 




Dial 


29 




Disable 


2F 




Write Break 


41 




Read Clear 


42 




Release 


D4 


L 


Reserve 


F4 



Figure 11. Channel Command Codes 



Code 



00 
01 



02 



03 



Definition 

Any command issued by on-line test routine for a 

local 3270 device. 
Disable, (when disable is the first command of the channel 

program) . 
Dial, 
Enable. 
Prepare. 

Write Pad characters. 
Write Wait-Bef ore-Transmit (WACK) . 
Sense (World Trade telegraph terminals) 



Write EOA EOT EOT EOT (i.e. r ©©(£)(£) sequence prior to 

selection. 
Write EOT ((c)) sequence prior to polling or addressing. 
Write response to text. 

Write EOA~((E)) and 15 idle characters (Basic 2740). 
Write EOA PRE o (2740 with 2760). 

Write polling or addressing characters. 

Write / (/ is the broadcast addressing character [2740 with 

Station Control]). 
Write turnaround sequence (TWX) . 
Write identification sequence (TWX, BSC) . 
Poll, (using SSALST, SSAWLST, AUTOLST,, or AUTOWLST form of 

terminal list. 
Write Inquiry (ENQ) character. 



Figure 12. TP-Op Codes for BTAM Channel Programs (Part 1 of 2) 
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Code 



04 



OS 
06 
07 
08 



09 

0A 

OB 
OC 
10 
11 

12 
13 
14 
20 
21 
22 
23 
24 



25 

L 



Definition 

Write Space character (2740 with Station Control). 

Write 2848 command (2260 Remote) . 

Write FIGS character (83B3). 

Write 1 (1030) • 

Write WRU, Write ID, Write Pad characters. Write LTRS 

characters (World Trade telegraph terminal). 
Sense (2740). 

Read response to polling. 

Read response to addressing. 

Read ID response (TWX, BSC) . 

Write EOA ( (5) ) character following end of addressing (1030, 

1050, 1060, 2260 Remote, 2740). 
Write response to inquiry (ENQ). 
Write response to text (BSC) . 
Write EOB^ ( ® ) (2740 with 2760). 

NOP or TIC following Poll command in a Read channel program 
using a polling list of the SSALST, SSAWLST, AUTOLST, or 
AUTOWLST form. 

Read index (Auto Poll) . 

Read response to polling (programmed polling). 

Read inquiry (ENQ) character (BSC). 

Read response to inquiry (ENQ) character (BSC). 

Write at display line address (2260 Remote). 

Read text. 

Write text. 

Write frame change sequence (2740 with 2760) . 

Read skit) or TIC command (dynamic buffering) . 

Write end -of -transparent text (DLE ^TX) characters (BSC). 

(Reserved) 

Read response to text (start-stop). 

All reset commands. 

Read skio. 

Write break. 

Any command issued during OPEN, LOPENJ, or CLOSE (Set Address, 
Enable, Disable, and Set Mode commands). 

Read Response to text (BSC) . 



Figure 12. TP-Op Codes for BTAM Channel Programs (Part 2 of 2) 
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START- STOP CHANNEL PROGRAMS 



CHANNEL PROGRAMS FOR AT6T 8 3B3 SELECTIVE 
CALLING STATIONS 



Read Initial Channel Program 



Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read Skip 


Zero 


SLI, Skip 


22 


Length 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write deselect chars 


Table 


CD 


02 


3 


(Figs., H, Ltrs.) 










2. Write polling chars 


List 


CC,SU 


03 


2 


3. Read response 


Area 


CD 


05 


2 


4. Read data 


Area +2 


SLI 


11 


Length -2 



Initiated by the read/write routine, the 
read initial channel program places the 
line in control mode, polls the terminals, 
and reads the response to polling. If the 
response is positive, the response will be 
read into the first byte of the input area. 
The positive response is followed by the 
message. Since the read response command 
specifies a count of 2 (with no suppress 
length) f the positive response followed by 
the message will reduce the count to zero 
and data chain to the read which will 
continue to read the data until the 
transmission is ended with an EOT. When a 
negative response is received on the read 
response, only one byte of data (the 
negative response) will be read into the 
message area and channel end/device end 
will occur (no unit exception). With the 
wrong length flag on and a nonzero data 
count, there is no data chaining to the 
next read command. Instead BTAW's channel 
end detects the polling TP-Op code and 
initializes for the next terminal to be 
polled by returning to IOS for execution 
with a pointer to the Write polling 
characters CCW. Polling is terminated if 
the channel end routine detects a 1 in bit 
7 of IOBFLAG2 which is turned on when 
RESETPL is executed for that line. The bit 
is turned off by read/write when another 
operation on that line is initiated. 
Polling also terminates when the end of 
list (EOL) bit is detected in an open list 
(OPENLST) . 



The read skip channel program reads the 
data from the terminal under the control of 
the count field. The suppress length flag 
is on. The skip flag is on and the data is 
not read into storage. 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write deselect chars 


Table 


CD 


02 


3 


(Figs., H. Ltrs.) 










2. Write addressing chars 


List 


CD 


03 


2 


3. Write Shift chars 


Table 


CC,SU 


04 


1 


(Ltrs.) 










4. Read response 


Respn 




06 


1 


5. Write data 


Area 


SLI 


11 


Length 



The write initial channel program places 
the line in control mode (to allow 
selection of the terminals) by sending 
Figs.,, H. , Ltrs., and addresses the 
terminal by sending two addressing 
characters. (The 83B3 requires a shift 
character after the addressing characters.) 
The response is read. The chaining flags 
of the read response command depend on the 
addressing list. If the user wishes to 
multi-address terminals (83B3), all of the 
terminals specified must be logically 
connected to the line before message 
transmission occurs. If a negative 
response is received from any terminal, the. 
channel program is terminated and the 
transmission is suppressed. 

If the addressing list entry specified 
in the WRITE macro- instruction has the EOL 
bit on (i.e., the entry is the last or only 
entry in the list), the read/write routine 
sets the command chaining bit on in the 
"read response to addressing" CCW; the 
multiple addressing indication is ignored 
and the entire channel program executes 
upon initiation by read/write. 

If the specified addressing list entry 
is not the last, the third command is not 
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altered and an interrupt occurs after the 
response is read. The channel end routine 
checks for a negative response. If the 
response is positive , the routine 
reinitializes the addressing list pointer 
in the CCW data address, leaves the command 
chaining bit off in the "read response to 
addressing" CCW, and returns control to the 
input/output supervisor for execution of 
commands beginning with the one containing 
a restart TP-Op code. This I/O 
supervisor-to-channel end loop continues 
until the end of the addressing list (EOL 
oit on) has been reached. On the last 
addressing pass, the "read response to 
addressing" CCW is command chained to the 
"write data" command. 



This macro-instruction causes a series 
of space characters to be placed on the 
line. The number of space characters 
transmitted is the number specified in the 
length parameter. The area address is 
ignored by the channel. 



Reset Following a Write 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(Figs., H, 7, Ltrs.,) 


Table 


SLI 


21 


9 



When dynamic buffering is encountered in 
the read/write routine, three additional 
commands are generated and inserted in the 
channel program following the write data 
command. Refer to section "Dynamic 
Buffering" for an explanation of the 
additional commands. 



The reset command, if specified is added 
to the corresponding channel program (i.e., 
WRITE TIR) . The single CCW, command 
chained from the last CCW in the base 
channel program, writes out nine special 
characters to transmit an end of 
transmission indication. 



Write Break Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Coun* 


1 . Write break 


Area 


SLI 


23 


Length 
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CHANNEL PROGRAMS FOR WESTERN UNION PLAN 
11 5 A OUTSTATIONS 



Read Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


3 


(Figs., H, Ltrs.) 










2. Write polling characters 


List 


CC, SLI 


03 


2 


3. Read response 


Area 


CD 


05 


2 


4. Read data 


Area+2 


SLI 


11 


Length-2 



The read initial channel program 
initiated by the read/write routine places 
the line in control mode by sending the 
Figs., H f Ltrs., sequence, polls the 
terminal with the two polling characters, 
and reads the response. 

The read response command specified a 
data count of 2, with wrong length 
indication not suppressed, whereas the 
length of the response is one byte. When a 
positive response character, and the first 
byte of the message are read under control 
of the "read response" CCW, it reduces the 
data count to zero and causes data chaining 
to take place. The rest of the message is 
read under control of the address and count 
fields of the "read data" CCW. The 
execution of the read continues in the 
channel until an interrupt occurs at the 
end of transmission. When, on a "read 



response" CCW, only one byte* a negative 
response is received,, a channel end/device 
end interrupt occurs. There is no unit 
exception indication- The data count of 2 
for a 1 byte polling response character 
signals wrong length which suppresses data 
chaining and allows BTAM to determine that 
a negative response was received. 

The channel end routine detects the 
polling restart TP-Op code and 
reinitializes for the next terminal to be 
polled. Control is returned to IOS for 
execution of the CCWs beginning with the 
one containing a "restart" TP-Op code. 
Polling is terminated if the channel end 
routine detects a 1 in bit 7 of IOBFLAG2 of 
the IOB for the line being polled* This 
bit is set on when the RESETPL 
macro- instruction is executed and is set 
off by the read/write routine when another 
operation on that line is initiated. 



Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read skip 


Zero 


SLI, SKIP 


22 


Length 



The read skip channel program reads the 
data from the terminal under the control of 
the count field. The suppress length flag 
is on along with the skip flag so the data 
is not read into storage. 
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Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


3 


(Figs., H, Ltrs.) 










2. Write addressing chars 


List 


CC, SLI 


03 


2 


3- Read response 


Respn 




06 


1 


4. Write data 


Area 


SLI 


11 


Length 



The Write initial channel program, 
initiated by the read/write routine, places 
the line in control mode (which allows it 
to be selected) , addresses the terminal, 
and reads the response to addressing. (The 
status of the chaining flags for the "read 
response" depends upon the status of the 
addressing list.) For multiple addressing, 
all the specified terminals must be 
logically connected to the line before 
message transmission can occur. A negative 
response from any terminal terminates the 
channel program and suppresses trans- 
mission. 



leaves the command chaining bit off in the 
"read response" CCW, and returns control to 
the input/output supervisor for execution 
of the commands beginning with the one 
containing the 03 TP-Op code. This loop 
continues until the EOL bit on is reached 
in the addressing list. At this time the 
read response CCW is command chained to the 
"write data" CCW. 



Write Break Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write break 


Area 


SLI 


23 


Length 



This macro-instruction causes a series 
of space characters to be placed on the 

line. The number of space characters, 
transmitted is the number specified in the 
length parameter. The area address is 
ignored by the channel. 



If the addressing list entry specified 
in the WRITE macro has the end of list 
(EOL) bit on, the read/write routine will 
set the command chaining bit on the "read 
response" CCW. The entire channel program 
executes upon initiation by read/write with 
the multiple addressing indication ignored. 

If the specified addressing list entry 
is not the last, the "read response" CCW is 
not altered and an interrupt occurs after 
the response is read. Channel end routine 
checks for a negative response which 
terminates the program and suppresses the 
transmission. If the response is positive, 
channel end reinitializes the addressing 
list pointer in the CCW data address. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(Figs., H, 7 Ltrs.) 


Table 


SLI 


21 


9 



The reset command, if specified is added 
to the corresponding channel program (i.e., 
WRITE TIR) . The single CCW, command 
chained from the last CCW in the base 
channel program, writes out nine special 
characters to transmit an end of 
transmission indication. 
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CHANNEL PROGRAMS FOR IBM 1030 TERMINALS 



Read Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


3 


(3 circle C s) 










2. Write polling character 


List 


CC, SLI 


03 


1 


3. Read response 


Area 


CD 


05 


2 


4. Reod data 


Area+2 


SLI 


11 


Length-2 



The read initial channel program places 
the line in control irode by sending three 
circle C, polls a terminal with one polling 
character , and reads the response to 
polling. The read response command has a 
data count of 2 with no suppressed length. 
Thus when the response (one byte) is read 
and it is a positive response, the response 
will be followed by data. This will reduce 
the count to zero and cause data chaining 
to read the rest of the data until an EOB 
or EOT is received or the count is zerc«. 
If the negative response is received, 
channel end/device end interrupt occurs 
with unit exception. There was no data 
chaining because wrong length indication 
and BTAM reinitializes to poll the next 
terminal of one was specified in the list. 
Polling is terminated if the channel end 
appendage detects a 1 in bit 7 of the 
IOBFLAG2 in the ICB for that line. This 
bit is on if a RESETPL has been executed 
and it is set when the read/write routine 
initiates another operation on that line. 
Polling also terminates when the end of 
list (EOL) bit is detected in an open list 
(OPENLST) . 



Read Continue Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write positive response and 
deselect characters (Circle Y 
and 3 circle Cs) 


Table 


CD 


02 


4 


2. Write polling characters 


List 


CC, SLI 


03 


1 


3. Read response 


Area 


CD 


05 


2 


4. Read data 


Area +2 


SLI 


11 


Length-2 



the message area with a count o 
There is no suppressed length. 
the response is read, and it is 
response (one byte) it will be 
followed by data. This causes 
be reduced to zero and data cha 
next CCW which will read until 
EOT is received or the count is 
if only one character is read, 
response, a channel end/device 
interrupt occurs with unit exce 



f two. 
Thus when 
a positive 
immediately 
the count to 
ining to the 
an EOB or 

zero. So 
a negative 
end 
ption. 



There is no data chaining due to wrong 
length and BTAM reinitializes the channel 
program to poll the next terminal,, if there 
is one in the list. Polling is terminated 
if channel end detects a 1 in bit 7 of the 
IOBFLAG2 in the IOB for that line which 
indicated a RESETP2 macro-instruction was 
issued for this line. This bit will be 
turned off when the read/write routine 
initiates another operation on the line. 
Polling is terminated when the EOL bit is 
detected. 



Read Repeat Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write negative response and 


Table 


CD 


02 


4 


deselect characters (Circle N 










and 3 circle Cs) 










2. Write polling characters 


L.st 


CC, SLI 


03 


1 


3. Read response 


Area 


CD 


05 


2 


4. Read data 


Area + 2 


SLI 


11 


Length-2 



The read repeat channel program sends a 
negative response N to the previous message 
block followed by three circle Cs to put 
the terminal in control mode. The terminal 
is then polled with one polling character. 
The channel program then proceeds the same 
way as the read initial channel program. 



Read Skip Channel Program 



Operation 


Addrew 


Flags 


TP-Op Code 


Count 


1 . Read Skip 


Zero 


SLI, Skip 


22 


Length 



The read continue channel program sends 
a positive response to the previous message 
block, followed by three circle Cs to put 
the terminal in control mode. The terminal 
is polled with one polling character and 
the response is read into the first byte of 



This macro-instruction causes a series 
of space characters to be placed on the 
line. The number of space characters 
transmitted is the number specified in the 
length parameter. The area address is 
ignored by the channel. 
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Reset Following a Read 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response and 
deselect characters 
(Circle Y and 3 circle C s) 


Table 


SU 


21 


4 



The reset CCW is chained to the last CCW 
of the basic channel program if READ TIR, 
TTR, or TPR is specified. This CCW sends a 
positive response to the transmission and 
three circle Cs. 



Initiated for the problem program 
through the read/write routine after a 
successful write initial , the write 
continue channel program writes data and 
then command chains to read the response 
from the terminal. This response is 
read into the DECRESPW+1 , which is 
the second byte of a two-byte response 
field in the DECB . 



Write Positive Acknowledge Channel Program 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. (Write 3 circle C s, 


Table 


CD 


02 


4 


Circle S) 










Write deselect characters 










2. Write addressing 


List 


CD 


03 


1 


characters 










3. Write "1" 


Table 


CC, SU 


04 


1 


4. Read addressing response 


Respn 


cc 


06 


1 


5. Write Circle D 


Table 


CD 


08 




6. Write data 


Area+1 


CC, SU 


11 


Length 


7. Read response 


Respn +1 




20 


1 



The write initial channel program sends 
three circle Cs, and a circle S to deselect 
the 1030 terminals, transmits a single 
addressing character followed by a 1, and 
reads the addressing response into the 
first byte of the DECRESPN in the DECB. 
Because multiple addressing is not possible 
with 1030 lines, the read response CCW is 
command chained to a "write circle D" CCW 
to send a circle D before the message. The 
circle D CCW data chained to write the 
message. This is followed by a CCW 
to read the response from the terminal. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response and 
deselect characters 
(Circle Y and 3 circle C s) 


Table 


SU 


21 


4 



The write positive acknowledge channel 
program sends a Y as a positive response 
and three circle Cs to deselect the 
terminal. 



Write Negative Acknowledge Channel P 


rogram 




Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(3 circle C s) 


Table 


SU 


21 


3 



Initiated by the read/write routine, the 
write negative acknowledge channel program 
sends three circle Cs to turn the terminal 
off. 



Reset Following a Write 



Write Continue Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write Data 
2. Read response 


Area 
Respn +1 


CC, SU 


11 
20 


Length 
1 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(3 circle C s) 


Table 


SU 


21 


3 



If a reset was specified by WRITE TIR or 
TTR, the reset function is performed by 
sending three Cs. 
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CHANNEL PROGRAMS FOR IBM 1050 LINES 



Read Continue Channel Program 



Read Initial Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


3 


(3 circle C s) 










2. Write polling characters 


List 


CC, SLI 


03 


2 


3. Read response 


Area 


CD 


05 


2 


4. Read data 


Area +2 


SLI 


11 


Length-2 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response 
(Circle Y) 

2. Read data 


Table 
Area 


CC, SLI 
SLI 


02 
11 


1 
Length 



The read continue channel program is 
initiated by the problem program through 
the read/write routine after a successful 
read initial operation; the program writes 
the response character and command chains 
to read data. 



The read initial channel program 
initiated by the read/write routine places 
the line in control mode, polls a terminal, 
and reads the response, (Control mode is 
that state of the system that allows a 
terminal to be selected.) The third 
command (read response character) specifies 
a data count of 2, with wrong length 
indication not suppressed , while the length 
of the response character is one byte. 
Under the existing configuration of BTAM, 
the effect of this technique is as follows: 



Positive Response: The response 
character and the first byte of the 
message are read under control of the 
"read response" CCW. This reduces the 
data count to zero and causes data 
chaining to take place. The second 
and subsequent bytes of the message 
are read under control of the address 
and count fields of the "read data" 
CCW. Execution continues in the 
channel with an interrupt occurring 
only at end of transmission. 



2. Negative Response: This response 

causes channel end and device end with 
unit exception and wrong length record 
indicated. The channel end routine 
detects the polling restart TP-Op 
code, reinitializes for the next 
terminal to be polled, and returns 
control to IOS for execution of the 
CCWs beginning with the one containing 
a 03 TP-Op code. 



Polling is terminated if the channel end 
routine detects a 1 in bit 7 of IOBFLAG2 of 
the IOB for the line being polled. This 
bit is set on when the RESETPL 
macro-instruction is executed and is set 
off by the read/write routine when another 
operation on that line is initiated. 



Read Repeat Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write negative response 
(Circle N) 

2. Read data 


Table 
Area 


CC, SLI 
SLI 


02 
11 


1 
Length 



The read repeat channel program is 
initiated by the problem program through 
the read/write routine after a data check 
occurs during execution of the 'read data* 
command of a read initial or read continue 
operation. The program transmits a 
negative response, and then chains to the 
second CCW to read data into the main 
storage area originally specified. 



Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read skip 


Zero 


SLI, Skip 


22 


Length 



Initiated by the read/write routine, the 
read skip channel program read the data in 
to clear the line* but it is not read into 
storage. 



Reset Following a Read 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write circle D and 
deselect characters 
(3 circle C s) 


Table 


SLI 


21 


4 
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If the reset function is specified by 
READ TIR, TTR f or TPR, then the circle D 
and 3 circle Cs are sent following the 
basic channel program. 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Wrjte deselect characters 


Table 


CD 


02 


3 


(3 circle C s) 










2. Write addressing chars 


List 


CC, SU 


03 


2 


3. Read response 


Respn 




06 


1 


4. Write circle D 


Table 


CD 


08 


1 


5. Write data 


Area 


CC, SU 


11 


Length 


6. Read response to LRC 


Respn +1 




20 


1 



"write circle D M command. The "write data" 
command always chains to the "read response 
to LRC" command. 



When dynamic buffering is encountered in 
the read/write routine, three additional 
commands are generated and inserted in the 
channel program following the write data 
command. Refer to section "Dynamic 
Buffering" for an explanation of the 
additional commands. 



Write Continue Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write Data 

2. Read response to LRC 


Area 
Respn +1 


CC, SLI 


11 
20 


Length 
1 



The write initial channel program, 
initiated by the read/write routine, places 
the line in control mode, addresses a 
terminal, and reads the response. The 
status of the chaining flags for the third 
command depends upon the status of the 
addressing list. For multiple component 
addressing, all specified components must 
be logically connected to the line before 
message transmission occurs. A negative 
response from any component terminates the 
channel program and suppresses 
transmission. 

If the addressing list entry specified 
in the WRITE macro-instruction has the EOL 
bit on (i.e,, the entry is the last or only 
entry in the list), the read/write routine 
sets the command chaining bit on in the 
"read response to addressing" CCW; the 
multiple addressing indication is ignored 
and the entire channel program executes 
upon initiation by read/write. 

If the specified addressing list entry 
is not the last, the third command is not 
altered and an interrupt occurs after the 
response is read. The channel end routine 
checks for a negative response. If the 
response is positive, the routine 
reinitializes the addressing list pointer 
in the CCW data address, leaves the 
commandchaining bit off in the "read 
response to addressing" CCW, and returns 
control to the input/output supervisor for 
execution of commands beginning with the 
one containing a restart TP-Op code. This 
I/O supervisor- to-channel end loop 
continues until the end of the addressing 
list (EOL bit on) has been reached. On the 
last addressing pass, the "read response to 
addressing" CCW is command chained to the 



The write continue channel program is 
initiated by the problem program through 
the read/write routine after a successful 
write initial operation; the program writes 
data and command chains to read the 
response to longitudinal redundancy 
checkina. The response is read into 
DECRESPN+1, the second byte of the 2-byte 
response field in the DECB. 

When dynamic buffering is encountered in 
the read/write routine, three additional 
commands are generated and inserted in the 
channel program following the write data 
command. Refer to the section "Dynamic 
Buffering" for an explanation of the 
additional commands. 



Write Continue Conversational Channel 
Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write data 


Area 


CC, SLI 


11 


Length 


2. Read response to LRC 


Respn +1 


CC, SLI 


20 


1 


3. Write deselect characters 


Table 


CD 


02 


3 


(3 circle Cs) 










4, Write polling characters 


List 


CC, SLI 


03 


2 


5. Read response 


Area 


CD 


05 


2 


6, Read data 


Area+2 


SLI 


11 


Length-2 



The write continue conversational 
channel program is initiated by the 
problem program through the read/write 
routine after a successful write initial 
operation. The program writes data, 
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command chains to read the response 
to longitudinal redundancy checking , 
command chains to place the line in 
control mode, polls a terminal, reads 
a response, and reads data on positive 
response. 



Write Negative Acknowledge Channel Proqram 




Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(3 circle C s) 


Table 


SU 


21 


3 



Write Positive Acknowledge Channel Proqram 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response and deselect 
characters (Circle D and 3 
circle Cs) 


Table 


SLI 


21 


4 



The acknowledge channel program, 
initiated by the read/write routine, 
transmits the positive response and three 
deselect characters to the terminal. The 
positive response character indicates to 
the terminal that the previous message was 
received without transmission errors by the 
CPU, After writing the circle D, the 
program writes the deselect characters. 



The negative acknowledge channel 
program, initiated by the read/write 
routine, writes the three deselect 
characters. 



Reset Following a Write 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(3 circle C s) 


Table 


SLI 


21 


3 



If the reset WRITE TIR or TTR is 
specified,, then three circle Cs are sent 
following the basic channel program if no 
errors occurred during transmission. 
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CHANNEL PROGRAMS FOR IBM 1050 DIAL 
(SWITCHED CONNECTION LINES) 



Read Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


). Disable 


Zero 


CC, SLI 


01 


1 


2. Dial 


List 


CC, SLI 


01 


Dial List 


Enable 


Zero 


SLI 


01 


1 


3. Write pad characters 


Table 


CC, SLI 


01 


15 


4. Write deselect characters 


Table 


CD 


02 


3 


(3 circle Cs) 










5. Write polling characters 


List 


CC, SLI 


03 


2 


6. Read response 


Area 


CD 


05 


2 


7. Read data 


Area +2 


SLI 


11 


Length-2 



are read under control of the address 
and count fields of the "read data" 
CCW. Execution continues in the 
channel with an interrupt occurring 
only at end of transmission, 

2 - Negative Response; This response 

causes channel end and device end with 
unit exception and wrong length record 
indicated. The channel end routine 
detects the read response to polling 
TP-Op code, reinitializes for the next 
terminal to be polled, and returns 
control to IOS for execution of the 
CCWs beginning with the one containing 
a 03 TP-Op code. 

Polling is terminated if the channel end 
routine detects a 1 in bit 7 of IOBFLAG2 of 
the IOB for the line being polled. This 
bit is set on when the RESETPL macro 
instruction is executed and is set off by 
the read/write routine when another 
operation on that line is initiated. 



The read initial channel program 
initiated by the read/write routine 
disables and then either (1) dials a 
terminal or (2) sets the enable latch 
within the line adapter so that the remote 
terminal may dial the CPU, The selection 
of dial or enable depends upon whether the 
problem program provides a dial list or an 
answer list when the READ Initial 
macro-instruction is issued. 

If the enable command is issued and the 
terminal dials the CPU, an interrupt occurs 
and the channel end routine turns on the 
arm-seeking bit in the seventh byte of the 
UCB, This is an indication to any 
subsequent halting of the I/O operation 
that data transmission has begun. If the 
bit is not turned on in the UCB after a 
READ Initial macro-instruction is given, 
the terminal has not dialed the CPU, After 
turning on the arm-seeking bit, the 
channel-end routine restarts the channel at 
the Write pad characters command. 

The fifteen pad characters are followed 
by three circle Cs to place the terminal in 
control mode. The two polling characters 
are sent. The sixth command (read response 
character) specifies a data count of 2, 
with wrong length indication not 
suppressed, while the length of the 
response character is one byte. Under 
BTAM, the effect of this technique is as 
follows: 

1, Positive Response: The response 

character and the first byte of the 
message are read under control of the 
"read response" CCW, This reduces the 
data count to zero and causes data 
chaining to take place. The second 
and subsequent bytes of the message 



Read Continue Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response 
(Circle Y) 

2. Read data 


Table 
Area 


CC, SLI 

SLI 


02 

11 


1 

Length 



The read continue channel program is 
initiated by the problem program through 
the read/write routine after a successful 
read initial operation; the program writes 
the response character and command chains 
to read data. 



Read Conversational Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


3 


(3 circle C s) 










2. Write polling characters 


List 


CC, SLI 


03 


2 


3. Read response 


Area 


CD 


05 


2 


4. Read data 


Area +2 


SLI 


11 


Length-2 



Initiated by read/write routine after 
the line connection has been established, 
the read conversational channel program 
places the line in control mode, polls a 
component of the terminal and then reads 
the response and data. The technique of 
Read commands is discussed in the 1050 Dial 
Read Initial Channel Program. 
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Read Repeat Channel Program 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write negative response 
(Circle N) 

2 . Read data 


Table 
Area 


CC, SLI 
SLI 


02 
11 


1 
Length 



The read repeat channel program is 
initiated by the problem program through 
the read/write routine after a transmission 
error occurred during execution of the 
•read data* command of a previous read 
operation. The program transmits a 
negative response, and then chains to the 
second CCW to read data into the main 
storage area originally specified. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Disable 


Zero 


CC, SLI 


01 


1 


2. Dial 


List 


CC, SLI 


01 


List 


Enable 


Zero 


SLI 


01 


1 


3. Write pad characters 


Table 


CD 


01 


15 


4. Write deselect characters 


Table 


CD 


02 


3 


(3 circle C s) 










5. Write addressing chars 


List 


CC, SLI 


03 


2 


6. Read response to address 


Respn 




06 


1 


7. Write end-of-addressing 


Table 


CD 


08 


1 


8. Write data 


Area 


CC, SLI 


11 


Length 


9. Read response to LRC 


Respn +1 




20 


1 



Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read skip 


Zero 


SLI,Skip 


22 


Length 



The write initial channel program 
initiated by the read/write routine 
disables and, then either: (1) dials a 
terminal., or (2) sets the enable latch 
within the line adapter so that the remote 
terminal may dial the CPU. The selection 
of dial or enable depends upon whether the 
problem program provides a dial list or an 
answer list when the WRITE Initial 
macro-instruction is issued. 



The read skip channel program reads the 
data from the terminal under the control of 
the count field. The suppress length flag 
is on. The skip flag is on and the data is 
not read into storage. 



Reset Following a Read 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response and 


Table 


CC, SLI 


21 


1 


deselect character 










(Circle D and circle C) 










2. Disable 


Zero 


SLI 


21 


1 



The reset if specified by READ TIR, TTR, 
TVR, or TPR is added to the end of the 
basic channel program. The sequence 
transmits a circle D to reply to the 
terminal and to halt transmission for it 
and an EOT character to deselect the remote 
terminal. It then issues a disable to 
disconnect the line. If no errors occurred 
during transmission, the reset function is 
performed. 



If the enable command is issued and the 
terminal dials the CPU, an interrupt occurs 
and the channel end routine turns on the 
arm-seeking bit in the seventh byte of the 
UCB. This is an indication to any 
subsequent halting of the I/O operation 
that data transmission has begun. If the 
bit is not turned on in the UCB after a 
WRITE Initial macro-instruction is given, 
the terminal has not dialed the CPU. After 
turning on the arm- seeking bit, the channel 
end routine restarts the channel at the 
Write pad characters command. 

After the pad characters, three circle 
Cs are sent to place the terminal in 
control mode. The addressing characters 
are sent to address the component (s) . The 
status of the chaining flags for the sixth 
command depends upon the status of the 
addressing list. For multiple component 
addressing, all specified components must 
be logically connected to the line before 
message transmission occurs. A negative 
response from any component terminates the 
channel program and suppresses 
transmission. 

If the addressing list entry specified 
in the WRITE macro- instruction has the EOL 
bit on (i.e., the entry is the last or only 
entry in the list)* the read/write routine 
sets the command chaining bit on in the 
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"read response to addressing" CCW; the 
multiple addressing indication is ignored 
and the entire channel program executes 
upon initiation by read/write. 



If the specified addressing list entry 
is not the last, the third command is not 
altered and an interrupt occurs after the 
response is read. The channel end routine 
checks for a negative response. If the 
response is positive, the routine 
reinitializes the addressing list pointer 
in the CCW data address, leaves the command 
chaining bit off in the "read response to 
addressing" CCW, and returns control to the 
input/output supervisor for execution of 
commands beginning with the one containing 
a 03 TP-Op code. This I/O supervisor- 
to-channel end loop continues until the end 
of the addressing list (EOL bit on) has 
been reached. On the last addressing pass, 
the "read response to addressing" CCW is 
command chained to the "write circle D" 
command. The "write data" command always 
chains to the "read response to LRC" 
command. 



When dynamic buffering is encountered in 
the read/write routine, three additional 
commands are generated and inserted in thf; 
channel program following the write data 
command. Refer to section "Dynamic 
Buffering" for an explanation of the 
additional commands* 



Write Continue Channel Program 



Write Conversation Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write data 

2. Read response to LRC 


Area 
Respn +1 


CC, SLI 


11 
20 


Length 
1 



After the line connection has previously 
been established, the write continue 
channel program is initiated by the problem 
program through the read/write routine; the 
program writes data and command chains to 
read the response to longitudinal 
redundancy checking. The response is read 
into DECRESPN+1, the second byte of the 
2-byte response field in the DECB. 

When dynamic buffering is encountered in 
the read/write routine, three additional 
commands are generated and inserted in the 
channel program following the write data 
command. Refer to the section "Dynamic 
Buffering" for an explanation of the 
additional commands. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response and deselect 


Table 


CD 


02 


4 


character (Circle D and 3 










circle Cs) 










2. Write addressing chars 


List 


CC, SLI 


03 


2 


3 . Read response 


Respn 




06 


1 


4. Write circle D 


Table 


CD 


08 


1 


5. Write data 


Area 


CC, SLI 


11 


Length 


6. Read response 


Respn+1 




20 


I 



The channel program transmits a circle D 
and 3 circle Cs with a single CCW. For a 
discussion of the channel program, see the 
"Write Initial Channel Program, " 



Write Continue Conversational Channel 



Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write data 


Area 


CC, SLI 


11 


Length 


2. Read response to LRC 


Respn+1 


CC, SLI 


20 


1 


3. Write deselect characters 


Table 


CD 


02 


3 


(3 circle Cs) 










4. Write polling characters 


List 


CC, SLI 


03 


2 


5. Read response 


Area 


CD 


05 


2 


6. Read data 


Area +2 


SLI 


11 


Length-2 



The write continue conversational channel 
program is initiated by the problem program 
through the read/write routine after a suc- 
cessful write initial operation. The pro- 
gram writes data, command chains to read the 
response to longitudinal redundancy checking, 
command chains to place the line in control 
mode, polls a terminal, reads a response, and 
reads data on positive response. 



Write Positive Acknowledge and Disconnect 
Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response and 
deselect character 
(Circle D and circle C) 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


2 

1 



54 



The write positive acknowledge and 
disconnect channel program resets the line 
after sending a positive response. The 
sequence transmits a circle D to reply to 
the terminal and to halt transmission for 
it and an EOT character to deselect the 
remote terminal. It then issues a disable 
to disconnect the line. 



Reset Following a Write 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect character 
(Circle C) 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


1 
1 



Write Negative Acknowledge and Disconnect 
Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect character 
(Circle C) 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


1 
1 



If a reset was specified by WRITE TIR, 
TTR, or TVR, the reset function sends a 
circle C to deselect the terminal and then 
disables the line. 



The write negative acknowledge and 
disconnect channel program sends a circle C 
to deselect the remote terminal and then 
issues a disable to disconnect the line. 
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CHANNEL PROGRAMS FOR IBM 1060 TERMINALS 



Read Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


3 


(3 circle C s) 










2. Write polling characters 


List 


CC, SLI 


03 


2 


3. Read response 


Area 


CD 


05 


2 


4. Read data 


Area +2 


SLI 


11 


Length -2 



The read initial channel program places 
the line in control mode by sending the 
circle C, polls a terminal with one polling 
character, and reads the response to 
polling. The read response command has a 
data count of 2 with no suppressed length. 
Thus, when the response (one byte) is read 
and it is a positive response, the response 
will be followed by data. This will reduce 
the count to zero and cause data chaining 
to read the rest of the data until an ECB 
or EOT is received or the count is zero. 
If the negative response is received, 
channel end/device end interrupt occurs 
with unit exception. There was no data 
chaining because of wrong length indication 
and BTAM reinitializes to poll the next 
terminal if one was specified in the list. 
Polling is terminated if the channel end 
appendage detects a 1 in bit 7 of the 
IOBFLAG2 in the IOB for that line. This 
bit is on if a RESETPL has been executed 
and it is set when the read/write routine 
initiates another operation on that line. 
Polling also terminates when the end of 
list (EOL) Dit is detected in an open list 
(OPENLST) . 



Read Continue Channel Program 



Operation 


Address 


Frags 


TP-Op Code 


Count 


1 . Write response and 
deselect characters 
(Circle Y and 3 circle C s) 


Table 


CD 


02 


4 


2. Write polling characters 


List 


CC, SLI 


03 


2 


3. Read response 


Area 


CD 


05 


2 


4. Read data 


Area +2 


SLI 


11 


Length-2 



the response is read into the first byte of 
the message area with a count of two. 
There is no suppressed length. Thus, when 
the response is read, and it is a positive 
response (one byte) it will be iirmediately 
followed by data. This causes count to be 
reduced to zero and data chaining to the 
next CCW which will read until an ECE or 
EOT is received or the count is zero. If 
only one character is read, a negative 
response, a channel end/device end 
interrupt occurs with unit exception. 
There is no data chaining due to wrong 
length and BTAM reinitializes the channel 
program to pell the next terminal, if there 
is one in the list. Polling is terminated 
if channel end detects a 1 in tit 7 of the 
ICBFLAG2 in the ICB for that line, which 
indicated a RESETPL macro-instruction was 
issued for this line. This bit will be 
turned off when the read/write routine 
initiates another operation on the line. 
Polling is terminated when the ECI bit is 
detected. 



Read Repeat Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write negative response 


Table 


CD 


02 


4 


and deselect characters 










(Circle N and 3 










circle C s) 










2. Write polling characters 


List 


CC, SLI 


03 


2 


3. Read response 


Area 


CD 


05 


2 


4. Read data 


Area +2 


SLI 


11 


Length-2 



The read repeat channel program sends a 
negative response N tc the previous 
message block followed by three circle Cs 
to put the terminal in control mode. The 
terminal is then polled with one polling 
character. The channel program then 
proceeds the same way as the read initial 
channel program. 



Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read skip 


Zero 


SU,Skip 


22 


Length 



The read continue channel program sends 
a positive response to the previous message 
block, followed by three circle Cs to put 
the terminal in control mode. The terminal 
is polled with one polling character and 



The read skip channel program reads the 
data from the terminal under the ccntrcl of 
the count field. The suppress length flag 
is on along with the skip flag sc the data 
is net read into storage. 
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Reset Following a Read 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write positive response 
and deselect characters 
(Circle Yand 3 circle Cs) 


Table 


SLI 


21 


4 



The reset CCW is chained to the last CCW 
of the basic channel program if READ TIR, 
TTR, or TPR is specified. This CCW sends a 
positive response to the transmission and 
three circle Cs, 



Write Initial Channel Program 
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to-channel 
of the add 
been reach 
the "read 
command ch 
command, 
chains to 
coirmand. 



it off in 

CCW, and 
ut supervi 
-Cp code, 
end loop 
ressing li 
ed. Cn th 
response t 
ained to t 
The "write 
the "read 



the "read re 

returns con 

sor for exec 

This I/C su 

continues un 

st (ECL bit 

e last addre 

o addressing 

he "write da 

data" comma 

response to 



sponse to 
trol to the 
uticn of a 
pervisor- 
til the end 
on) has 
ssing pass, 

CCW is 
ta" 

nd always 
IRC" 



When dynamic buffering is encountered in 
the read/write routine, three additional 
commands are generated and inserted in the 
channel program following the write data 
command. Refer to section "Dynamic 
Euffering" for an explanation of the 
additional commands. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


3 


(3 circle C s) 










2. Write addressing chars 


List 


CC, SLI 


03 


2 


3. Read response 


Respn 




06 


1 


4. Write circle D 


Table 


CD 


08 


1 


5. Write data 


Area 


CC, SLI 


11 


Length 


6. Read response to LRC 


Respn +1 


SLI 


20 


1 



The write initial channel program, 
initiated by the read/write routine, places 
the line in control mode, addresses a 
terminal, and reads the response. The 
status of the chaining flags for the third 
command depends upon the status of the 
addressing list. For multiple addressing, 
all specified terminals must be logically 
connected to the line before message 
transmission occurs. A negative response 
from any terminal terminates the channel 
program and suppresses transmission. 

If trie addressing list entry specified 
in the WRITE macro-instruction has the ECL 
bit on (i.e., the entry is the last or only 
entry in the list) , the read/write routine 
sets the command chaining bit on in the 
"read response to addressing" CCW; the 
multiple addressing indication is ignored 
and the entire channel program executes 
upon initiation by read/write. 

If the specified addressing list entry 
is not the last, the third command is not 
altered and an interrupt occurs after the 
response is read. The channel end routine 
checks for a negative response. If the 
response is positive, the routine 
reinitializes the addressing list pointer 
in the CCW data address, leaves the command 



Writ e Po s itive Acknowledge Channel Progra m 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response and 
deselect characters 
(Circle Y and 3 circle C s) 


Table 


SLI 


21 


4 



The write positive acknowledge channel 
program sends a Y as a positive response 
and three circle Cs to deselect the 
terminal. 



Write Negative Acknowl 


edge Channel Program 




Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(3 circle C s) 


Table 


SLI 


21 


3 



Initiated by the read/write routine, the 
write negative acknowledge channel program 
sends three circle Cs to turn the terminal 
off. 



Reset Fo l lo w ing a Writ e 



Operation 


Address 


Fiags 


TP-Op Code 


Count 


1 . Write deselect characters 
(3 circle C s) 


Table 


SLI 


21 


3 



If the reset was specified by WRITE TIR, 
then the three circle Cs are sent to 
deselect the terminal. 
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CHANNEL PROGRAMS FOR TTY MODELS 33 AND 35 
TWX LINES 



the read/write routine after a successful 
write initial operation. 



Read Initial Channel Program 



Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Disable 


Zero 


CC, SLI 


01 


1 


2. Enable 


Zero 


SLI 


01 


1 


3. Write pad characters 


Table 


CD 


01 


15 


4. Write identification 


List 


CC, SLI 


03 


List 


5 . Read data 


Area 


SLI 


11 


Length 



The read initial channel program, 
initiated by the read/write routine 
performs the following: 

Disables the line in case not done 
previously. 

Sets the enable latch within the line 
adapter so that the remote terminal may 
dial the CPU. 

Sends pad characters. 

Writes the identification assigned to 
the CPU by the user's answer list. 

Reads the data transmitted by the 
terminal. 

After the enable command has been issued 
and the terminal has dialed the CPU, a 
channel end/device end interrupt occurs and 
the channel end appendage turns on the 
arm-seeking bit in the seventh byte of the 
UCB. This is an indication to any 
subsequent halting of I/O operations that 
data transmission has begun. If the bit is 
not turned on in the UCB after a read 
initial macro-instruction is given, the 
terminal has not dialed the CPU. After 
turning on the arm- seeking bit, the channel 
end appendage restarts the channel at the 
fourth command (write identification) . 



Read Conversational Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write turnaround char 
2. Read data 


List 
Area 


CC, SLI 
SLI 


03 
11 


List 

Length 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read skip 


Zero 


SLI, Skip 


22 


Length 



Initiated by the read/write routine, the 
read skip channel program read the data in 
to clear the line, but it is not read into 
storage. 



R e set Fo l lowinq a Read 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write EOT 


Table 


CC, SLI 


21 


1 


(CiicleC) 










2. Disable 


Zero 


SLI 


21 


1 



If READ TIR or TVR is specified, the 
reset function is added to the end of basic 
channel program and is executed cnly if the 
basic channel program completed without 
error. The reset will send a circle C tc 
deselect the terminal and then disable the 
line. 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Disable 


Zero 


CC, SLI 


01 


1 


2. Dial 


List 


CC, SLI 


01 


List 


3. Read identification 


List 




07 


List 


4. Write data 


Area 


SLI 


11 


Length 



The read conversational channel program 
is initiated by the problem program through 



The write initial channel program, 
initiated by the read/write routine, 
disables and dials a terminal and, if the 
identification received was valid, writes 
the data to the terminal. If the 
identification was invalid, the channel 
program is terminated. 

After the CPU has read the 
identification sent frcm the terminal, an 
interrupt occurs and the channel end 
routine compares the identification 
received with the identification supplied 
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by the user in the dial list. If an 
unequal compare results, the channel end 
routine posts the buffer; if dynamic 
buffering was specified. The event is 
posted complete- If an equal 
identification is received, it is assumed 
the correct terminal has been contacted and 
the channel is restarted with the write 
data command. 



The write negative acknowledge channel 
program, initiated by the read/write 
routine, writes an end-of-transmission 
character to the terminal and resets, with 
a disable command, the enable latch within 
the line adapter. 



Reset Following a Write 



Write Conversational Channel 


Program 








Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write data 


Area 


SLI 


11 


Length 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write EOT 

2. Disable 


Table 
Area 


CC, SLI 
SLI 


Reset 
Reset 


1 
1 



The write conversational channel program 
is initiated by the problem program 
throughthe read/write routine after a 
successful read initial operation. 



If WRITE TIR or TVR is specified* the 
reset function is added to the end of the 
basic channel programs. The program writes 
an end-of-transmission character to the 
terminal and resets, with a disable 
command, the enable latch within the line 
adapter. 



Write Negative 


Acknowledge Channel Program 




Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write EOT 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


1 
1 



Start-Stop Channel Programs 59 



CHANNEL PROGRAMS FOR IBM 2740 
COMMUNICATIONS LINES 



IBM 2740 BASIC CHANNEL PROGRAMS 



The read skip channel program reads the 
data from the terminal under the control of 
the count field. The suppress length flag 
is on. The skip flag is on and the data is 
not read into storage. 



Read Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect character 


Table 


CC, SLI 


21 


1 


(1 circle C) 










2. Prepare 


Zero 


CC, SLI 


01 


1 


3 . Sense 


Respn+1 


CC, SLI 


04 


1 


4. Read data 


Area 


SLI 


11 


Length 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write circle D and 15 


Table 


CD 


02 


16 


idle characters 










2. Write data 


Area 


SLI 


11 


Length 



The read initial channel program places 
the terminal in control mode and sends the 
prepare command to condition the control 
unit to receive a message from the terminal. 
The prepare command removes the circle D 
from the beginning of the message and the 
count is reduced to zero, causing command 
chaining to the sense command and to the 
read command that reads the message. 



The write initial channel program sends 
a circle D and fifteen idle characters and 
data chains to the write data to send the 
message. 



Reset Following a Write 



Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read skip 


Zero 


SLI, Skip 


22 


Length 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(3 circle C s) 


Table 


SLI 


21 


3 



If reset was specified by WRITE TIR, the 
reset function will send the three circle 
Cs if no errors occurred during the 
previous transmission. 
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IBM 2740 WITH CHECKING 



Read Skip Channel Program 



Read Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect character 


Table 


CC, SLI 


02 


1 


(1 circle C) 










2. Prepare 


Zero 


CC, SLI 


01 


1 


3. Sense 


Respn+1 


CC, SLI 


04 


1 


4. Read data 


Area 


SLI 


11 


Length 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read skip 


Zero 


SLI, Skip 


22 


Length 



The read skip channel program reads the 
data from the terminal under the control of 
the count field. The suppress length flag 
is on. The skip flag is on and the data is 
not read into storage. 



The Prepare command conditions the 
control unit to receive a message and then 
command chains to the Read command when a 
character is received. The circle D sent 
by the transmitting terminal is deleted by 
the Prepare command. 



Reset Following a Read 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write circle D and 
deselect characters 
(3 circle C s) 


Table 


SLI 


21 


4 



Read Continue Channel Program 



Operation 


Address 


Flags 


>-Op Code 


Count 


1 . Write response 
(Circle Y) 

2. Read data 


Table 
Area 


CC, SLI 
SLI 


02 

n 


1 
Length 



If the reset is specified by READ TIR, 
TTR, or TPR, the reset function will send 
the circle D and three circle Cs if no 
errors occurred on the data transmissions. 



Write Initial Channel Program 



The read continue channel program is 
initiated by the problem program through 
the read/write routine after a successful 
read initial operation; the program writes 
the response character and command chains 
to read data. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write circle D and 15 
idle characters 


Table 


CD 


02 


16 


2. Write data 


Area 


CC, SLI 


11 


Length 


3. Read response to 
VRC/LRS 


Respn+1 




20 


1 



Read Repeat Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write negative response 
(Circle N) 

2. Read data 


Table 
Area 


CC, SLI 
SLI 


02 
11 


1 
Length 



The write initial channel program sends 
the circle D to put the terminal in control 
mode and fifteen idle characters to allow 
terminal motors to get up to speed. This 
Write command data chains to the Write data 
command which sends the message and command 
chains to the Read response command. 



The read repeat channel program is 
initiated by the problem program through 
the read/write routine after a transmission 
error occurred during execution of the 
•read data' command of a read initial or 
read continue operation. The program 
transmits .a negative response , and then 
chains to the second CCW to read data into 
the main storage area originally specified. 



Write Continue Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write data 

2. Read response to 
VRC/LRC 


Area 
Respn+1 


CC, SLI 


11 
20 


Length 

1 
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The write continue channel program will 
write the data and then command chain to 
read the response into DECRESPN+1 (VRC/LRC 
response field in the DECB) . 



Write Conversational Channel Program 



Write Positive Acknowledge Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write circle D and 
deselect characters 
(3 circle C s) 


Table 


SLI 


21 


4 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write circle D 


Table 


CD 


02 


1 


2. Write data 


Area 


CC, SLI 


11 


Length 


3. Read response to 
VRC/LRC 


Respn+1 




20 


1 



The write positive acknowledge channel 
program sends a circle D as a positive 
response and three circle Cs to deselect 
the terminal. 



The write conversational channel program 
first writes a circle D to put the terminal 
in receive mode and then data chains to the 
next write to send the data. When the 
count is zero, this command chains to read 
the VRC/LRC response into the response 
field of the DECB (DECRESPN+1). 



Write Negative Acknowledge Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write deselect characters 
(3 circle C s) 


Table 


SLI 


21 


3 



Write Continue Conversational Channel 
Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write data 


Area 


CC, SLI 


11 


Length 


2. Read response to LRC 


Respn+1 


CC, SLI 


20 


1 


3. Write deselect character 


Table 


CC, SLI 


02 


1 


(1 circle C) 










4. Prepare 


Zero 


CC, SLI 


01 


1 


5. Sense 


Zero 


CC, SLI 


04 


1 


6. Read data 


Area 


SLI 


11 


Length 



Initiated by the read/write routine, the 
write negative acknowledge channel program 
sends three circle Cs to turn the terminal 
off. 



Reset Following a Write 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(3 circle C s) 


Table 


SLI 


21 


3 



The write continue conversational channel 
program is initiated by the problem program 
through the read/write routine after a 
successful write initial operation; the 
program writes data, command chains to read 
the response to longitudinal redundancy 
checking, command chains to place the line 
in control mode, command chains to the 
prepare command which removes the circle D 
from the beginning of the message, and 
command chains to read the message. 



If the reset is specified by WRITE TIR, 
TTR or TVR, then the three circle Cs are 
sent to turn the terminal motors off. The 
reset will be performed only if no errors 
occurred during the write for this reset. 
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IBM 2740 WITH CHECKING AND 2760 ATTACHMENT 



In this publication, the term "response" is 
used instead of "answerback" to signify 
response to LRC/VRC check, to maintain 
consistency with the other 2740 channel 
program explanations. In the OS BTAM SRL 
publication, the term answerback is used, 
to maintain consistency with the IBM 2760 
Optical Image Unit Component Description 
publication (GA27-3011) • The two terms are 
synonymous • 



Read Continue with Leading Acknowledgment 
Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write EOA EOT EOT EOT 


Table 


CC,SLI 


21 


4 


2. Prepare 





CC,SLI 


01 


1 


3. Sense 


Respn 


CC,SU 


04 


1 


4. Read Text 


Area 


SLI 


11 


Length 



Read Initial Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write EOT EOT EOT 


Table 


CC,SLI 


21 


3 


2. Prepare 





CC,SLI 


01 


1 


3. Sense 


Respn 


CC,SLI 


04 


1 


4. Read text 


Area 


SLI 


11 


Length 



The Read Continue with Leading 
Acknowledgment channel program sends EOA as 
positive response to text and an EOT 
sequence to place the terminal in standby 
status; prepares the TCU data adapter to 
receive text; receives a sense byte into 
the DECB response field; and receives 
message text. (The EOA with which the 
terminal precedes message text is deleted 
by the Prepare command.) 



Read Repeat Channel Program 



In the Read Initial channel program, the 
Write command sets the terminal to standby 
status; the Prepare command monitors the 
line for an incoming EOA; when EOA is 
received, the sense command receives a 
sense byte into the DECB response field, 
and the Read text command receives message 
text. 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write response 
(circle N) 

2. Read text 


Table 
Area 


CC,SLI 
SLI 


02 
11 


1 
Length 



Read Continue Channel Program 



The Read Repeat channel orogram sends a 
negative response and receives another 
message block (which should be the same 
text as received by the previous Read 
operation) . 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write response 
(Circle Y) 

2. Read text 


Table 
Area 


CC,SLI 
SLI 


02 
11 


1 
Length 



Read Skip Channel Program 



The Read Continue channel program sends 
a positive response and receives another 
message block. 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Read skip 





SLI, Skip 


22 


Length 



The Read Skip channel program receives a 
message block but does not place it in main 
storage. 
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Reset Following a Read 



Write Conversational Channel Program 



Operation 


Address 


Flogs 


Tp-Op Code 


Count 


1 . Write EOA EOT EOT EOT 


Table 


SLI 


21 


4 



The Reset function , specified by the 
READ TIR, TTR, or TPR macro, is added to 
the end of the basic channel program (but 
is executed only if the text was received 
correctly) • The EOA signifies positive 
response to text; the EOTs reset the 
terminal to standby status. 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write EOA 

2. Write text 

3. Read response 


Table 
Area 
Respn+1 


CD 
CC,SLI 


02 
11 
20 


1 

Length 

1 



The Write Conversational channel program 
sends EOA to place the terminal in receive 
status , sends text, and reads response to 
text* 



Write Initial Channel Program 



Write Initial Optical Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write EOA and 15 Idle 


Table 


CD 


02 


16 


characters 










2. Write text 


Area 


CC,SLI 


11 


Length 


3. Read response 


Respn+1 




20 


1 



The Write Initial channel program sends 
EOA to place the terminal in receive status 
and 15 idle characters to allow terminal 
motors to reach operating speed; sends 
text, and receives response to text in 
DECRESPN+1. 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Write EOA PRE o 


Table 


CD 


02 


3 


2. Write frame change sequence 


List 


CD 


11 


3 


3. Write EOB 


Table 


CC,SLI 


08 


1 


4. Read response 


Respn +1 


CC,SLI 


20 


1 


5. Write EOT EOT EOT 


Table 


SLI 


21 


3 



Write Continue Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write text 

2. Read response 


Area 
Respn+1 


CC,SLI 


1) 
20 


Length 

1 



The Write Initial Optical channel 
program sends EOA PRE o to place terminal 
in receive status and indicate that the 
subsequent message text is for the 2760; 
sends a frame change message and EOB; reads 
response to text; and resets the terminal 
to standby status if the response is 
positive (the EOT sequence also causes the 
2760 to execute the frame change function). 



The Write Continue Channel program sends 
a message block and receives response to 
text in DECRESPN+1. 

When dynamic buffering is used, three 
additional commands are generated and 
inserted in the channel program following 
the Write Text coirroand. See the section 
Dynamic Buffering for an explanation of 
these commands. 
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Write Invitational Optical Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write EOA PRE o 


Table 


CD 


02 


3 


2. Write frame change 


Entry 


CD 


1) 


3 


sequence 










3. Write EOB 


Table 


CC,SLI 


08 


1 


4. Read response 


Respn+1 


CC,SLI 


20 


1 


5. Write EOT EOT EOT 


Table 


CC,SLI 


21 


3 


6. Prepare 




CC,SLI 


01 


1 


7. Sense 


Respn 


CC,SLI 


04 


1 


8. Read text 


Area 


SLI 


11 


Length 



The Write Positive Acknowledgment 
channel program sends EOA as positive 
response to text and three EOTs to place 
the terminal in standby status. 



Write Negative Acknowledgment Channel 
Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write EOT EOT EOT 


Table 


SLI 


21 


3 



The Write Invitational Optical channel 
program sends EOA PRE o to place the 
terminal in receive status and indicate 
that the subsequent message text is for the 
2760; sends a frame change message and EOB; 
reads response to text; resets the terminal 
to standby status if response is positive 
(the EOT sequence also causes the 2760 to 
execute the frame change function) ; 
prepares the TCU data adapter to receive 
text; receives a sense byte into the DECB 
response field; and reads message text, 
(The EOA with which the terminal precedes 
message text is deleted by the Prepare 
command,) 



The Write Negative Acknowledgment 
channel program sends three EOTs to place 
the terminal in standby status; the EOTs 
also signify negative response to text, if 
the channel program is executed following a 
Read operation. 



Reset Following a write 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write EOT EOT EOT 


Table 


SLI 


21 


3 



Write Positive Acknowledgment Channel 



Program 


Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write EOA EOT EOT EOT 


Table 


SLI 


21 


4 



The Reset function, specified by the 
WRITE TIR, TTR f or TVR, is executed at the 
end of the basic channel program (only if a 
positive response to text was received by 
the preceding command) . The EOTs reset the 
terminal to standby status. 
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IBM 2740 WITH DIAL 



Read Initial Channel Program 



is on. The skip flag is on and the data is 
not read into storage. 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Disable 


Zero 


CC, SLI 


01 


1 


2. Enable 


Zero 


CC, SU 


01 


1 


3. Prepare 


Zero 


CC, SLI 


01 


1 


4. Read data 


Area 


SLI 


11 


Length 



Reset Following a Read 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect character 
(Circle C) 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


1 
1 



Initiated by the read/write routine, the 
read initial channel program disables and 
then enables the line to receive a call. 
When a call is received, the Enable command 
chains to the Prepare command which 
conditions the control unit to receive a 
message. When a character is received, the 
count goes to zero and the Prepare command 
command chains to read the data. The 
Prepare command deletes the circle D which 
is sent by the depression of the BID key at 
the transmitting terminal. 



Read Conversational Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Prepare 
2. Read 


Zero 
Area 


CC, SLI 
SLI 


01 
11 


1 
Length 



The read conversational channel program 
sends the Prepare command to condition the 
control unit to receive a message from a 
terminal. The Prepare command removes the 
circle D from the beginning of the message 
and the count is reduced to zero, causing 
command chaining to the read which reads 
the message. 



If reset is specified by READ TIR or 
TVR, the reset commands are added to the 
basic channel program and are executed if 
no errors occurred during the execution of 
the basic channel program. 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Disable 


Zero 


CC, SLI 


01 


1 


2. Dial 


List + 1 


CC, SLI 


01 


List 


3. Write pad characters 


Table 


CC, SLI 


01 


15 


4. Write circle D 


Table 


CD 


02 


1 


5. Write data 


Area 


SLI 


11 


Length 



Initiated by the read/write routine* the 
write initial channel program disables the 
line and command chains to the Dial command 
to dial the terminal specified by the 
DFTRMLST macro- instruction. After dialing, 
the channel program sends fifteen pad 
characters before command chaining 
to a write circle D command which is 
sent before the data. 



Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read skip 


Zero 


SLI, Skip 


22 


Length 



The read skip channel program reads the 
data from the terminal under the control of 
the count field. The suppress length flag 



Write Conversational Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write circle D 

2. Write data 


Table 
Area 


CD 
SLI 


02 
11 


1 
Length 



The write conversational channel program 
sends a circle D and then data chains when 
the count is zero to a write data command 
to send the message. 
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Write Disconnect Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect character 
(Circle C) 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


1 
1 



If reset is specified by WRITE TIR or 
TVR, the reset commands are added to the 
corresponding channel programs. They are 
executed when the basic channel program 
completes without error. 



The write disconnect channel program 
sends a circle C to put the terminal in 
control mode and command chains to disable 
the line. 



Reset Following a Write 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect character 
(CircleC) 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


1 
1 
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IBM 27U0 WITH DIAL AND CHECKING 



Read Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Disable 


Zero 


CC, SLI 


01 


1 


2. Enable 


Zero 


CC, SLI 


01 


1 


3. Prepare 


Zero 


CC, SLI 


01 


1 


4. Read data 


Area 


SLI 


11 


Length 



Initiated by the read/write routine, the 
read initial channel program disables and 
then enables the line to receive a call. 
When a call is received, the Enable command 
chains to the Prepare command which 
conditions the control unit to receive a 
message. When a character is received, the 
count goes to zero and the Prepare command 
command chains to read the data. The 
Prepare command deletes the circle D which 
is sent by the depression of the BID key at 
the transmitting terminal. 



Read Continue Channel Program 



control mode and then chains to the Prepare 
command. The Prepare command conditions 
the control unit to receive a message. 
When the first character, a circle D caused 
by the depression of the transmitting 
terminal's BID key, is received, it is 
deleted by the Prepare command which chains 
to read the data. 



Read Repeat Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write negative response 
(Circle N) 

2. Read data 


Table 
Area 


CC, SLI 
SLI 


02 
11 


1 
Length 



The read repeat channel program is 
initiated by the problem program through 
the read/write routine after a transmission 
error occurred during execution of the 
• read data 1 command of a previous read 
operation. The program transmits a 
negative response, and then chains to the 
second CCW to read data into the main 
storage area originally specified. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response 
(Circle Y) 

2. Read data 


Table 
Area 


CC, SLI 
SLI 


02 
11 


1 
Length 



The read continue channel program is 
initiated by the problem program through 
the read/write routine after a successful 
read initial operation; the program writes 
the response character and command chains 
to read data. 



Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code Count 


1 .Read skip 


Zero 


SLI, SKIP 


22 Length 



Initiated by the read/write routine, the 
read skip channel program read the data in 
to clear the line but it is not read into 
storage. 



Read Conversational Channel Program 



Reset Following a Read 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write 3 circle C s 


Table 


CC, SLI 


02 


3 


2. Prepare 


Zero 


CC, SLI 


01 


1 


3. Read 


Area 


SLI 


11 


Length 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 .Write response 
and deselect chars 
(Circle D and 
circle C) 

2. Disable 


Table 
Zero 


CC,SLI 
SLI 


21 
21 


2 

1 



Initiated by the read/write routine, the 
read conversational channel program sends 
three circle Cs to put the terminal in 



The reset if specified by READ TIR f TTR, 
TVR, or TPR is added to the end of the (; 
basic channel program. The sequence 
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transmits a circle D to reply to the 
terminal and to halt transmission for it 
and an EOT character to deselect the remote 
terminal. It then issues a disable to 
disconnect the line. If no errors occured 
during transmission, the reset function is 
performed. 



channel program following the write data 
command. Refer to the section "Dynamic 
Buffering- for an explanation of the 
additional commands. 



Reset Following a Write 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Od Code 


Count 


1. Disable 


Zero 


CC, SLI 


01 


1 


2. Dial 


List 


CC, SLI 


01 


List 4 


3. Write Pad Characters 


Table 


CC, SLI 


01 


15 


4. Write circle D 


Table 


CD 


02 


1 


5. Write data 


Area 


CC, SLI 


11 


Length 


6. Read response to VRC/LRC 


Respn+1 




20 


1 



Initiated by the read/write routine, the 
write initial channel program disables the 
line before dialing the terminal specified 
by the DFTRMLST. The fifteen pad 
characters are sent to allow the terminal 
motors to reach the necessary speed before 
the message is sent to it. Before the data 
is sent, a circle D is sent to the terminal. 
After the message is sent the response to 
VRC/LRC is read into the response field in 
the DECii (DECRESPN+1) . 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write EOT EOT EOT 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


3 
1 



Write Conversational Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write circle D 


Table 


CD 


02 


1 


2. Write data 


Area 


CC, SLI 


11 


Length 


3 . Read response to VRC/LRC 


Respn+1 




20 


1 



The Write conversational channel program 
sends a circle D after the line has 
previously been established. The data is 
sent and the "Write data" command chains to 
the "read response" CCW. 



Write Continue Channel Program 



Operation 


Address 


Flags 


TP-Op Code Count 


1 . Write data 

2 . Read response to LRC 


Area 
Respn+1 


CC, SLI 


1 1 Length 
20 1 



After the line connection has previously 
been established , the write continue 
channel program is initiated by the problem 
program through the read/write routine; the 
program writes! data and command chains to 
read the response to longitudinal 
redundancy checking. The response is read 
into DECRESPN+1 , the second byte of the 
2 -byte response field in the DECB. 

When dynamic buffering is encountered in 
the read/write routine , three ddditional 
commands are generated and inserted in the 



Write Continue Conversational Channel 
Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write data 


Area 


CC, SLI 


11 


Length 


2. Read response to LRC 


Respn+1 


CC, SLI 


20 


1 


3. Write deselect character 


Table 


CC, SLI 


02 


1 


(1 circle C) 










4. Prepore 


Zero 


CC, SLI 


01 


1 


5. Sense 


Zero 


CC, SLI 


04 


1 


6. Read data 


Area 


SLI 


11 


Length 



The write continue conversational channel 
program is initiated by the problem program 
through the read/write routine after a 
successful write initial operation; the 
program writes data, command chains to read 
the response to longitudinal redundancy 
checking, command chains to place the line 
in control mode, command chains to the 
prepare command which removes the circle D 
from the beginning of the message, and 
command chains to read the message. 
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Write Positive Acknowledge and Disconnect 
Channel Program 



Operation 


Address 


Flogs 


TP-Op Code 


Count 


1 . Write response and 
deselect character 
(Circle D and circle C) 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


2 

1 



The Read Initial channel program 
disables the line, then enables it to 
receive a call. When a call is received, 
the Prepare command deletes the EOA sent by 
the Bid key at the terminal, the Sense 
command receives a sense byte into the DECB 
response field, and the Read text command 
receives message text. 



Read Continue Channel Program 



The Write positive acknowledge and 
disconnect channel program resets the line 
after sending a positive response. The 
sequence transmits a circle D to reply to 
the terminal and to halt transmission for 
it and an EOT character to deselect the 
remote terminal. It then issues a disable 
to disconnect the line. 



Write Negative Acknowledge and Disconnect 
Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write response 
(circle Y) 

2. Read text 


Table 
Area 


CC,SLI 
SLI 


02 
11 


1 
Length 



The Read Continue channel program sends 
a positive response and receives another 
message block. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect character 
(Circle C) 

2. Disable 


Table 
Zero 


CC, SLI 

SLI 


21 
21 


1 
1 



IBM 2740 WITH DIAL, CHECKING, AND 2760 
ATTACHMENT 



Read Continue with Leading Acknowledgment 
Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write EOA EOT EOT EOT 


Table 


CC,SLI 


21 


4 


2. Prepare 





CC,SLI 


01 


J 


3. Sense 


Respn 


CC,SLI 


04 


1 


4. Read text 


Area 


SLI 


11 


Length 



In this publication, the term "response" is 
used instead of "answerback" to signify 
response to LRC/VRC check, to maintain 
consistency with the other 27 40 channel 
program explanations. In the OS BTAM SRL 
publication, the term answerback is used to 
maintain consistency with the IBM 2760 
Optical Image Unit Component Description 
(Form A27-301 1) . The two terms are 
synonymous . 



The Read Continue with Leading 
Acknowledgment channel program sends EOA as 
positive response to text and an EOT 
seguence to place the terminal in standby 
status; prepares the TCU data adapter to 
receive text; receives a sense byte into 
the DECB response field; and receives 
message text. (The EOA with which the 
terminal precedes message text is deleted 
by the Prepare command.) 



Read Initial Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Disable 





CC,SLI 


01 


1 


2. Enable 





CC,SLI 


01 


1 


3. Prepare 





CC,SLI 


01 


1 


4. Sense 


Respn 


CC,SLI 


04 


I 


5. Read text 


Area 


SLI 


11 


Length 



Read Conversational Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write EOT EOT EOT 


Table 


CC,SLI 


02 


3 


2. Prepare 





CC,SLI 


01 


I 


3. Sense 


Respn 


CC,SLI 


04 


1 


4. Read text 


Area 


SLI 


11 


Length 
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The Read Conversational channel program 
first places the terminal in standby 
status. The Prepare command deletes the 
EOA sent by the Bid key at the terminal , 
the Sense command receives a sense byte 
into the DECB response field, and the Read 
Text command receives message text. 



Read Repeat Channel Program 



Write Initial Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Write response 
(circle N) 

2. Read text 


Table 
Area 


CC,SU 
SLI 


02 
1] 


1 
Length 



The Read Repeat channel program sends a 
negative response and receives another 
message block (which should be the same 
text as received by the previous Read 
operation) • 



Operation 


Address 


Flags 


Tp-Cp Code 


Count 


1. Disable 





CC,SLI 


01 


1 


2. Dial 


List 


* CC,SU 


01 


List 


3. Write pad characters 


Table 


CC,SLI 


01 


15 


4. Write EOA 


Table 


CD 


02 


I 


5. Write text 


Area 


CC,SLI 


11 


Length 


6. Read response 


Respn+J 




20 


1 



The Write Initial channel program 
disables the line, dials a remote terminal, 
sends 15 pad characters to allow terminal 
motors to reach operating speed, sends EOA 
to place terminal in receive status, sends 
text, and receives response to text in 
DECRESPN+1. 



Write Continue Channel Program 



Read Skip Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Read skip 





SU,Skip 


22 


Length 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Write text 

2. Read response 


Area 
Respn+1 


CC,SLI 


11 
20 


Length 

1 



The Write Continue Channel program sends 
a message block and receives response to 
text in DECRESPN+1, 



The Read Skip channel program receives a 
message block but does not place it in main 
storage. 



Reset Following a Read 



When dynamic buffering is used, three 
additional commands are generated and 
inserted in the channel program following 
the Write Text command. See the section 
Dynamic Buffering for an explanation of 
these commands. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write EOA EOT EOT EOT 

2. Disable 


Table 



CC, SLI 
SLI 


21 
21 


4 

1 



The Reset function, specified by the 
READ TIR, TTR, TVR, or TPR, is executed at 
the end of the basic channel program (only 
if the text was received correctly) . The 

first command sends an EOA and 3 EOTs to 
signify positive response to text and to 
reset the terminal to standby status. The 
second command breaks the line connection. 



Write Conversational Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Write EOA 

2. Write text 

3. Read response 


Table 
Area 
Respn+1 


CD 
CC,SLI 


02 
11 
20 


1 

Length 

1 



The Write Conversational channel program 
sends EOA to place the terminal in receive 
status, sends text, and reads response to 
text. 
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Write Initial Optical Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Disable 





CC,SLI 


01 


1 


2. Dial 


List 


CC,SLI 


01 


List 


3. Write pad characters 


Table 


CC,SLI 


01 


15 


4. Write EOA PRE o 


Table 


CD 


02 


3 


5. Write frame change 


List 


CD 


11 


3 


sequence 










6. Write EOB 


Table 


CC,SLI 


08 


1 


7. Read response 


Respn+1 


CC,SLI 


20 


I 


8. Write EOT EOT EOT 


Table 


SLI 


21 


3 



terminal in receive status and indicate 
that the subsequent message text is for the 
2760; sends a frame change message and EOB; 
reads response to text; resets the terminal 
to standby if response is positive (the EOT 
sequence also causes the 2760 to execute 
the frame change function) ; prepares the 
TCU data adapter to receive text; receives 
a sense byte into the DECB response field; 
and reads message text. (The EOA with 
which the terminal precedes message text is 
deleted by the Prepare command.) 



Write Conversational Optical Channel 
Program 



The Write Initial Optical channel 
program disables the line; dials a remote 
terminal; sends 15 pad characters to allow 
terminal motors to reach operating speed; 
sends EOA PRE o to place terminal in 
receive status and indicate that the 
subsequent message text is for the 2760; 
sends a frame change message and EOB; reads 
response to text; and resets the terminal 
to standby status if the response is 
positive, (The EOT sequence also causes 
the 2760 to execute the frame change 
function, ) 



Write Invitational Optical Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Write EOA PRE o 


Table 


CD 


02 


3 


2. Write frame change 


Entry 


CD 


11 


3 


sequence 










3. Write EOB 


Table 


CC,SLI 


08 


1 


4. Read response 


Respn+1 


CC,SLI 


20 


1 


5. Write EOT EOT EOT 


Table 


SLI 


21 


3 



The Write Conversational Optical channel 
program sends EOA PRE o to place the 
terminal in receive status and indicate 
that the subsequent message text is for the 
2760; sends a frame change message and EOB; 
reads response to text; and resets the 
terminal to standby status if the response 
is positive. (The EOT sequence also causes 
the 2760 to execute the frame change 
function, ) 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write EOA PRE o 


Table 


CD 


02 


3 


2. Write frame change sequence 


Entry 


CD 


11 


3 


3. Write EOB 


Table 


CC, SLI 


08 


1 


4. Read Response 


Respn+1 


CC, SLI 


20 


1 


5. Write EOT EOT EOT 


Table 


CC, SLI 


02 


3 


6. Prepare 





CC, SLI 


01 


1 


7. Sense 


Respn 


CC, SLI 


04 


1 


8. Read text 


Area 


SLI 


11 


Length 



Write Positive Acknowledgment Channel 
Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Write EOA EOT EOT EOT 

2. Disable 


Table 



CC,SLI 
SLI 


21 
21 


4 
1 



The Write Invitational Optical channel 
program sends EOA PRE o to place the 



The Write Positive Acknowledgment 
channel program sends EOA as positive 
response to text and three EOTs to place 
the terminal in standby status, then breaks 
the line connection. 
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Write Neqative Acknowledgment 


Channel 


Proqram 


Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write EOT EOT EOT 
2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


3 



The Write Negative Acknowledgment channel 
program sends three EOTs to place the terminal 
in standby status (the EOTs also signify 
negative response to text, if the channel 
program is executed following a Read 
operation) , then breaks the line connection . 
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IBM 2740 WITH DIAL AND TRANSMIT CONTROL 



Read Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Disable 


Zero 


CC, SLI 


01 


1 


2. Dial 


List 


CC, SLI 


01 


Dial List 


Enable 


Zero 


SLI 


01 


1 


3. Write pad characters 


Table 


CC, SLI 


01 


15 


4. Write selection characters 


Table 


CC, SLI 


03 


2 


5. Read response 


Area 


CD 


05 


2 


6. Read data 


Area +2 


SLI 


11 


Length -2 



The read initial channel program 
initiated by the read/write routine 
disables and then either (1) dials a 
terminal or (2) sets the enable latch 
within the line adapter so that the remote 
terminal may dial the CPU. The selection 
of dial or enable depends upon whether the 
problem program provides a dial list or an 
answer list when the Read Initial 
macro-instruction is issued. 

If the enable command is issued and the 
terminal dials the CPU, an interrupt occurs 
and the channel end routine turns on the 
arm- seeking bit in the seventh byte of the 
UCB. This is an indication to any 
subsequent halting of the I/O operation 
that data transmission has begun. If the 
bit is not turned on in the UCE after a 
read initial macro-instruction is given, 
the terminal has not dialed the CPU. After 
turning on the arm-seeking bit, the 
channel-end routine restarts the channel at 
the Write pad characters command. 

The fifteen pad characters are followed 
by the selection character (/ space) to 
select the fifth command (read response 
character) . The read response CCW 
specifies a data count of 2, with wrong 
length indication not suppressed, while the 
length of the response character is one 
byte. Under ETAM, the effect of this 
technique is as follows: 



data" CCW. Execution continues in the 
channel with an interrupt occurring 
only at the end of the transmission. 

Negative Response: This respcnse 
causes channel end and device end with 
unit exception and wrong length record 
indicated. There is no polling of 
component (s) or terminal (s) on the 
2740DT; only the sending of the 
selection characters. 



Rea<3 Conversational Channel Prog ram 





Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write selection chars 
(/ space) 


Table 


CC, SLI 


03 


2 


2. Read response 


Area 


CD 


05 


2 


3. Read data 


Area +2 


SLI 


11 


Length-2 



The read conversaticnal chann 
sends the selection characters ( 
allow the terminal to send a ires 
response is read into the first 
of the message area. (See the R 
section of the 2740DT fcr a disc 
the positive or negative respons 
respcnse was positive the "read 
CCW data chains to read the rest 
message. 



Read Skip Channel Program 



el program 
1 space) to 
sage. The 
two bytes 
ead Initial 
ussicn cf 
e.) If the 
respcnse" 
of the 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read skip 


Zero 


SLI, Skip 


22 


Length 



Initiated by the read/write routine, the 
read skip channel prcgram read the data in 
to clear the line but it is not read into 
storage. 



1 * Positive Response: The response 

character, a circle D caused by the 
depression of the transmitting 
terminals BID key, and the first byte 
of the message are read under control 
of the "read response" CCW. This 
reduces the data count to zero and 
causes data chaining to take place. 
The second and subsequent bytes of the 
message are read under control of the 
address and count fields of the "read 



Reset Following a Read 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect character 
(Circle C) 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


1 
1 
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If reset is specified by READ TIR or 
TVR, the reset commands are added to the 
basic cnannel program and are executed if 
no errors occurred during the execution of 
the basic channel program. 



Buffering" for an explanation of the 
additional commands. 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Disable 


Zero 


CC, SLI 


01 


1 


2. Enable 


Zero 


SLI 


01 


1 


Dial 


List 


CC, SLI 


01 


List 


3. Write pad characters 


Table 


CC, SLI 


01 


15 


4. Write circle D 


Table 


CD 


08 


1 


5. Write data 


Area 


SLI 


11 


Length 



Write Conversationa 


1 Channel 


Program 








Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write circle D 

2. Write data 


Table 
Area 


CD 
SLI 


08 
11 


1 
Length 



The write conversational channel program 
sends a circle B and then data chains when 
the count is to a Write data command to 
send the message. 



The write initial channel program 
initiated by the read/write routine 
disables and, then either: (1) dials a 
terminal, or (2) sets the enable latch 
within the line adapter so that the remote 
terminal may dial the CPU. The selection 
of dial or enable depends upon whether the 
problem program provides a dial list or an 
answer list when the WRITE Initial 
macro-instruction is issued. 

If the enable command is issued and the 
terminal dials the CPU, an interrupt occurs 
and the channel end routine turns on the 
arm-seeking bit in the seventh byte of the 
UCB. This is an indication to any 
subsequent halting of the I/O operation 
that data transmission has begun. If the 
bit is not turned on in the UCB after a 
write initial macro-instruction is given, 
the terminal has not dialed the CPU. After 
turning on the arm-seeking bit, the channel 
end routine restarts the channel at the 
Write pad characters command. 

After the pad characters, the channel 
program data chains to send a circle D 
before sending the data. 

Wnen dynamic buffering is encountered in 
the read/write routine, three additional 
commands are generated and inserted in the 
channel program following the write data 
command. Refer to section "Dynamic 



Write Disconnect Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect character 
(Circle C) 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


1 
1 



The Write disconnect channel program 
sends a circle C to put the terminal in 
control mode and command chains to disable 
the line. 



Reset Following a Write 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect character 
(Circle C) 

2. Disable 


Table 
Zero 


CC, SLI 
SU 


21 
21 


1 
1 



If reset is specified by WRITE TIR or 
TVR, the reset commands are added to the 
corresponding channel programs. They are 
executed when the basic channel program 
completes without error. 
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IBM 2740 WITH DIAL, TRANSMIT CONTROL , AND 
CHECKING 



Read Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Disable 


Zero 


CC, SLI 


01 


1 


2. Enable 


Zero 


SLI 


01 


1 


Dial 


List 


CC, SLI 


01 


List 


3. Write pad characters 


Table 


CC, SLI 


01 


15 


4. Write selection chars (/ space) 


Toble 


CC, SLI 


03 


2 


5. Read response 


Area 


CD 


05 


2 


6. Read data 


Area +2 


SLI 


11 


Length -2 



reduces the data count to zero and 
causes data chaining to take place. 
The second and subseguent bytes of the 
rressage are read under control of the 
address and count fields of the "read 
data" CCW. Execution continues in the 
channel with an interrupt cccurring 
only at the end of the transmission. 



Negative Response : This response 
causes channel end and device end with 
exception and wrong length record 
indicated. There is nc polling of 
component (s) or terminal (s) on the 
2740DT; only the sending of the 
selection characters. 



The read initial channel program 
initiated by the read/write routine 
disables and then either (1) dials a 
terminal or (2) sets the enable latch 
within the line adapter so that the remote 
terminal may dial the CPU. The selection 
of dial or enable depends upon whether the 
problem program provides a dial list or an 
answer list when the Read Initial 
macro-instruction is issued. 



Read Continue Channel Frogram 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response 
(Circle Y) 

2. Read data 


Table 
Area 


CC, SLI 
SLI 


02 

11 


1 
Length 



If the enable command is issued and the 
terminal dials the CPU, an interrupt occurs 
and the channel end routine turns on the 
arm- seeking bit in the seventh byte of the 
UCB. This is an indication to any 
subseguent halting of the I/O operation 
that data transmission has begun. If the 
bit is not turned on in the UCB after a 
read initial macro-instruction is given, 
the terminal has not dialed the CPU. After 
turning on the arm-seeking bit, the 
channel-end routine restarts the channel at 
the Write pad characters command. 



The fifteen pad characters are followed 
by the selection character (/ space) to 
select the fifth command (read response 
character) specifies a data count of 2, 
with wrong length indication not 
suppressed, while the length of the 
response character is one byte. Under 
BTAM, the effect of this technique is as 
follows: 



Positive Response; The response 
character, a circle D caused by the 
depression of the transmitting 
terminals BID key, and the first byte 
of the message are read under control 
of the "read response" CCW. This 



After the line connection has previously 
been established, the read continue channel 
program is initiated by the problem program 
through the read/write routine; the program 
writes the response character and command 
chains tc read data. 



Read Repeat Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write negative response 
(Circle N) 

2. Read data 


Table 
Area 


CC, SLI 
SLI 


02 
11 


1 

Length 



The read repeat channel program is 
initiated by the problem program through 
the read/write routine after a data check 
occurred during execution of the 'read 
data 1 command of a read initial or read 
continue operation. The program transmits 
a negative response, and then chains to the 
second CCW to read data into the main 
storage area originally specified. 
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Read Conversational Channel Program 



Operation 


Address 


Flags 


JP-Op Code 


Count 


1 . Write 3 circle C s 


Table 


CD 


02 


3 


2. Write selection char 
(/space) 


Table 


CC, su 


03 


2 


3. Read response 


Area 


CD 


05 


2 


4. Read data 


Area +2 


SU 


11 


Length -2 



If there is dynamic buffering , three 
additional commands are generated in the 
channel program following the Write data 
command. See the section "Dynamic 
Buffering" for an explanation of the 
additional commands. 



Write Initial Channel Program 



The read conversational channel program 
is initiated by the read/write routine. 
The channel program sends the three circle 
Cs to put the terminal in control mode 
prior to sending the selection characters 
which tells the terminal it can now send. 
The response is read into the first two 
bytes of the message area. If the response 
is negative, only one byte, an interrupt 
occurs and the channel end routine 
recognizes that is is a negative response 
and the channel program is terminated. If 
the response is positive, it will be 
followed by a data. After the first two 
bytes are read, the count is reduced to 
zero and this CCW data chains to finish 
reading the message. 



Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read Skip 


Zero 


SU, Skip 


22 


Length 



Initiated by the read/write routine, the 
read skip channel program read the data in 
to clear the line but it is not read into 
storage. 



Reset Following a Read 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write response and 
deselect character 
(Circle D and circle C) 

2. Disable 


Table 
Zero 


CC, SLI 
SU 


21 
21 


1 
1 



If READ TIR, TTR, TPR, or TVR is 
specified, the reset function is added to 
the end of basic channel program and is 
executed only if the basic channel program 
completed without error. The reset will 
send a circle D and a circle C to deselect 
the terminal and then disable the line. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Disable 


Zero 


CC, SLI 


01 


1 


2. Enable 


Zero 


SLI 


01 


1 


Dial 


List 


CC, SLI 


01 


List 


3. Write pad characters 


Table 


CC, SLI 


01 


15 


4. Write circle D 


Table 


CD 


08 


1 


5. Write data 


Area 


SLI 


11 


Length 


6. Read response to VRC/LRC 


Respn+) 




20 


1 



The write initial channel program 
initiated by the read/write routine 
disables and, then either: (1) dials a 
terminal, or (2) sets the enable latch 
within the line adapter so that the r"emcte 
terminal may dial the CPU. The selection 
of dial or enable depends upon whether the 
problem program provides a dial list or an 
answer list when the WRITE Initial 
macro-instruction is issued. 



If the enable command is issued and the 
terminal dials the CPU, an interrupt occurs 
and the channel end routine turns en the 
arm-seeking bit in the seventh byte of the 
UCB. This is an indication to any 
subsequent halting of the I/C operation 
that data transmission has begun. If the 
bit is not turned on in the UCB after a 
write initial macro-instruction is given, 
the terminal has not dialed the CPU. After 
turning en the arm-seeking tit, the channel 
end routine restarts the channel at the 
Write pad characters command- 
After the pad characters, the channel 
program data chains to send a circle D 
before sending the data. The response tc 
VRC/LRC is read into the second byte of the 
field in the DECB (DECRESPN+1) . 

, When dynamic buffering is encountered in 
the read/write routine, three additional 
commands are generated and inserted in the 
channel program following the write data 
command. Refer to section "Dynamic 
Buffering" for an explanation of the 
additional commands. 
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Write Continue Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write data 

2 . Read response to VRC/LRC 


Area 
Respn+1 


CC, SLI 


11 
20 


Length 

1 



The write continue channel program will 
write the data and then command chain to 
read the response into DECRESPN+1 (VRC/LRC 
response field in the DECB. 



Write Conversational Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


l. Write Circle D 


Table 


CD 


02 


1 


2. Write data 


Area 


CC, SLI 


11 


Length 


3. Read response to 
VRC/LRC 


Respn+1 




20 


1 



The write conversational channel program 
first writes a circle D to put the terminal 
in receive mode and then data chains to the 
next write to send the data. When the 
count is zero, this command chains to read 
to VRC/LRC response into the response field 
of the DECB (DECRESPN+1) . 



The Write positive acknowledge channel 
program sends a circle C as a positive 
response followed by a circle D to place 
the terminal in control mode. The line is 
then disabled. 



Wr i te_ Negative Acknowledge Chan nel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write EOT 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


1 
1 



The Write negative acknowledge channel 
program initiated by the read/write 
routine, writes an end-cf-transmissicn 
character tc the terminal and resets, with 
a disable command, the enable latch within 
the line adapter. 



Reset Following a Writ e 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write EOT 

2. Disable 


Table 
Area 


CC, SLI 
SLI 


Reset 
Reset 


1 
1 



Write Positive Acknowledge and Disconnec t 
Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write circle D and 
deselect character 
(Circle C) 

2. Disable 


Table 
Zero 


CC, SLI 
SLI 


21 
21 


2 

1 



If WRITE TIR, TTR, cr TVR is specified, 
the reset function is added to the end of 
the basic channel programs. The program 
writes an end-of-transmission character to 
the terminal and resets, with a disable 
command, the enable latch within the line 
adapter. 



78 



IBM 2740 WITH STATION CONTROL 



Read Initial Channel Program 



Initiated by the read/write routine, the 
read skip channel program read the data in 
to clear the line but it is not read into 
storage. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


3 


(3 circle C b) 










2. Write polling character 


List 


CD 


03 


1 


3. Write space character 


Table 


CC, SLI 


04 


1 


4. Read response 


Area 


CD 


05 


2 


5. Read data 


Area +2 


SLI 


11 


Length-2 



Initiated by the read/write routine, the 
read initial channel program places the 
line in control mode, polls the terminals, 
with one character followed by a space 
character, and reads the response to 
polling. If the response is positive, the 
response will be read into the first byte 
of the input area. The positive response 
is followed by the message. Since the read 
response command specifies a count of 2 

(with no suppress length) , the positive 
response followed by the message will 
reduce the count to zero and data chain to 
the read will continue to read the data 
until the transmission is ended with an 
EOT. When a negative response is received 
on the read response, only one byte of data 

(the negative response) will be read into 
the message area and channel end/device end 
occurs (no unit exception) . With the wrong 
length flag on and a nonzero data count, 
there is no data chaining to the next read 
command. Instead BTAM'S channel end 
detects the polling TP-Op code and 
initializes for the next terminal to be 
polled by returning to IOS for execution 
with a pointer to the Write polling 
characters CCW. Polling is terminated if 
the channel end routine detects a 1 in bit 
7 of IOBFLAGS which is turned on when 
RESETPL is executed for that line. The bit 
is turned off by read/write when another 
operation on that line is initiated. 
Polling also terminates when the end of 
list (EOL) bit is detected in an open list 

(OPENLST) . 

Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read skip 


Zero 


SLI, Skip 


22 


Length 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


4 


(3 circle Cs and circle S) 










2. Write addressing character 


List 


CD 


03 


1 


3. Write space character 


Table 


CC, SLI 


04 


1 


4. Read response 


Respn 


SLI 


06 


2 


5. Write circle D 


Table 


CD 


04 


1 


6. Write data 


Area 


SLI 


11 


Length 



The write initial channel program places 
the terminal in control mode and sends a 
circle S to denote that addressing will 
follow. The terminal is addressed with a 
one character code followed by a space 
character. The response to addressing is 
read into the first byte of the response 
field in the DECB (DECRESPN) . The Write 
circle D "CCW" data chains to write the data. 



Reset Following a Write 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(3 circle C s) 


Table 


SLI 


21 


3 



If the reset is specified by WRITE TIR, 
then the three circle Cs are sent to turn 
the teririnal irotors off. The reset will be 
performed only if no errors occurred during 
the write fcr this reset. 



Start-Stop Channel Programs 79 



IBM 2740 WITH STATION CONTROL AND CHECKING 



Read Continue Channel Program 



Read Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


3 


(3 circle C s) 


- 








2. Write polling character 


List 


CD 


03 


1 


3. Write space character 


Table 


CC, SLI 


04 


1 


4. Read response 


Area 


CD 


05 


2 


5. Read data 


Area +2 


SLI 


11 


Length-2 



The read initial channel program 
initiated by the read/write routine places 
the line in control mode, polls a terminal 
with one character followed by a space 
character and reads the response. (Control 
mode is that state of the system that 
allows a terminal to be selected.) The 
third command (read response character) 
specifies a data count of 2, with wrong 
length indication not suppressed, while the 
length of the response character is one 
byte. Under the existing configuration of 
BTAM, the effect of this technigue is as 
follows: 



1. Positive Response: The response 

character and the first byte of the 
message are read under control of the 
"read response" CCW. This reduces the 
data count to zero and causes data 
chaining to take place. The second 
and subsequent bytes of the message 
are read under control of the address 
and count fields of the "read data" 
CCW. Execution continues in the 
channel with an interrupt occurring 
only at the end of transmission. 



2. Negative Response: This response 

causes channel end and device end with 
unit exception and wrong length record 
indicated. The channel end routine 
detects the polling restart TP-Cp 
code, reinitializes for the next 
terminal to be polled, and returns 
control to IOS for execution of the 
CCrts beginning with the one containing 
a 03 TP-Op code. 

Polling is terminated if the channel end 
routine detects a 1 in bit 7 of ICBFIAG2 of 
the IOB for 'the line being polled. This 
bit is set on when the RESETPL 
macro-instruction is executed and is set 
off by the read/write routine when another 
operation on that line is initiated. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 Write response (Circle Y) 
2. Read data 


Table 
Area 


CC, SLI 
SLI 


02 
11 


1 
Length 



The read continue channel program is 
initiated by the problem program through 
the read/write routine after a successful 
read initial operation; the program writes 
the response character and command chains 
to read data. 



Read Repeat Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write negative response (Circle N) 
2 . Read data 


Table 
Area 


CC, SLI 
SLI 


02 
11 


1 
Length 



The read repeat channel program is 
initiated by the problem program through 
the read/write routine after a data check 
occurs during execution of the 'read data' 
command of a read initial or read continue 
operation. The program transmits a 
negative response, and then chains to the 
second CCW to read data into the main 
storage area originally specified. 



Read Skip Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read Skip 


Zero 


SLI, Skip 


22 


Length 



Initiated by the read/write routine, the 
read skip channel program read the data in 
to clear the line but it is not read into 

storage. 



Reset Following a Read 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write circle D and 
deselect characters 
(3 circle C s) 


Table 


SLI 


21 


4 



The reset CCVv is chained to the last CCft 
of the basic channel program if READ TIR, 
TTR, or TPR is specified. This CCVv sends a 
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positive response to the transmission and 
three circle Cs. 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


4 


(3 circle Cs and circle S) 










2. Write addressing characters 


List 


CD 


03 


1 


3. Write space characters 


Table 


CC, SLI 


04 


1 


4. Read response 


Respn 


SLI 


06 


2 


5. Write circle D 


Table 


CD 


08 


1 


6. Write data 


Area 


CC, SLI 


11 


Length 


7. Read response 


Respn* 1 




20 


1 



The write initial channel program, 
initiated by the read/write routine, places 
the line in control mode and informs it 
that the addressing function will follow by 
circle S, addresses a terminal with a one 
character code followed by a space 
character, and reads the response. The 
status of the chaining flags for the third 
command depends upon the status of the 
addressing list. For multiple component 
addressing, all specified components must 
be logically connected to the line before 
message transmission occurs. A negative 
response from any component terminates the 
channel program and suppresses 
transmission. 



If the addressin 
in the WRITE macro- 
bit on (i.e., the e 
entry in the list) , 
sets the command ch 
"read response to a 
multiple addressing 
and the entire chan 
upon initiation by 



g list entry specified 
instruction has the ECL 
ntry is the last or only 

the read/write routine 
aining bit on in the 
ddressing" CCrt: the 

indication is ignored 
nel program executes 
read/write. 



If the specified addressing list entry 
is not the last, the third command is not 
altered and an interrupt occurs after the 
response is read. The channel end routine 
checks for a negative response. If the 
response is positive, the routine 
reinitializes the addressing list pointer 
in the CCW data address, leaves the command 
chaining bit off in the "read response to 
addressing" CCW, and returns control to the 
input/output "supervisor for execution of 
commands beginning with the one containing 
a restart TP-Op code. This I/O 
supervisor-to-channel end loop continues 
until the end of the addressing list (ECL 
bit on) has oeen reached. On the last 



addressing pass, the "read response to 
addressing" CCW is command chained to the 
"write circle E" command. The "write data" 
command always chains to the "read response 
to LRC" command. 

When dynamic buffering is encountered in 
the read/write routine, three additional 
commands are generated and inserted in the 
channel program following the write data 
command. Refer to section "Dynamic 
Euffering" for an explanation of the 
additional commands. 



Write Continue Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write data 

2. Read response to LRC 


Area 
Respn +1 


CC, SLI 


11 
20 


Length 
1 



The write continue channel program is 
initiated by the problem program through 
the read/write routine after a successful 
write initial operation; the program writes 
data and command chains to read the 
response to longitudinal redundancy 
checking. The response is read into 
DECRESPN+1, the second byte of the 2-byte 
response field in the DECB. 

When dynamic buffering is encountered in 
the read/write routine, three additional 
commands are generated and inserted in the 
channel program following the write data 
command. Refer to the section "Dynamic 
Euffering" for an explanation of the 
additional commands. 



Write Positive Acknowledge Channel P rogram 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 .Write response and 
deselect characters 
(Circle D and 3 
circle C s) 


Table 


SLI 


21 


4 



The acknowledge channel program, 
initiated by the read/write routine, 
transmits the positive response character 
and three deselect characters to the 
terminal. The positive response character 
indicates tc the terminal that the previous 
message was received without transmission 
errors by the CPU. After writing the 
circle D, the program writes the deselect 
characters. 
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Write Negative Aknowledge 


Channel Program 




Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characteis 
(3 circle Cs) 


Table 


SLI 


21 


3 



Reset Following a Write 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write EOT 


Table 


CC, SLI 


21 


1 



The write negative acknowledge channel 
program, initiated by the read/write routine, 
writes the three deselect characters* 



If reset was specified by WRITE TIR or 
TTR the reset function is added to the 
basic channel program. It is performed 
only if the basic program completed without 
any errors. 
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CHANNEL PROGRAMS FOR IBM 2741 
COMMUNICATIONS TERMINALS 



Read Continue Channel Program 

Read Conversational Channel Program 



Read Initial Channel Program (Nonswitched 
Line) 



Read Conversational Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Prepare 

2. Inhibit 



Area 


CC,SLI 
SLI 


01 
11 


1 
Length 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Wr.te EOT 


Table 


CC,SLI 


02 


1 


2. Prepare 





CC,SLI 


01 


1 


3. Inhibit 


Area 


SLI 


11 


Length 



The prepare coirmand conditions the TCU 
to read data from the terminal. The 
Prepare is completed when the first 
character , EOA, is received from the 
terminal. The inhibit command reads the 
message text into the input area. 



Read Initial Channel Program (Switched 
Line) 



The Write EOT command sets the terminal 
to transmit state. The Prepare command 
conditions the TCU to read data from the 
terminal; the Prepare is completed when the 
first character, EOA f is received from the 
terminal. The Inhibit command reads the 
message text into the input area. 

The same sequence of commands is used 
for both the Read Continue and the Read 
Conversational channel programs. 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Disable 





CC,SLI 


01 


1 


2. Enable 





CC,SLI 


01 


1 


3. Prepare 





CC,SLI 


01 


J 


4. Inhibit 


Area 


SLI 


11 


Length 



Read Skip Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Inhibit 





SLI, Skip 


22 


Length 



This channel program disables, then 
enables the line to receive a call from a 
remote terminal. The Prepare command 
conditions the TCU to read data from the 
terminal; the command is completed when the 
first character, EOA, is received. The 
Inhibit command reads the message text into 
the input area. 



The Inhibit command reads data from the 
terminal, but because the Skip flag is on, 
does not place it in main storage. 



Write Continue Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 . Write text 


Area 


SLI 


11 


Length 



The Write text command sends message 
text to the terminal. This channel program 
is for use after a Write Conversational 
channel program has set the terminal to 
receive state. 



Start-Stop Channel Programs 83 



Write Conversational Channel Program 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 Wiite EOA 

2 Write text 


Table 
Area 


CD 

SLI 


02 
1) 


1 
Length 



The Write text command sends message 
text to the terminal, and the Write EOT 
command sets the terminal to transmit 
state. The Prepare command conditions the 
TCU to read data from the terminal; this 
command is completed when the first 
character, EOA, is received from the 
terminal. The Inhibit command reads the 
message text into the input area. 



The Write EOA command sets the terminal 
to receive state, then data chains to write 
message text. This channel program is for 
use after a Read operation, to reverse the 
direction of transmission. 



This channel program is for use after a 
Write Continue or Write Conversational 
operation, to reverse the direction of 
transmission. 



Write Continue Conversational Channel 
Program 



Write Disconnect Channel Program (Switched 
Line Only) 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1 Write -ext 


Area 


CC,SU 


1) 


Length 


2 Write EOT 


Table 


CC,SLI 


02 


1 


3 Prepare 





CC,SLI 


0) 


I 


4. Inhibit 


Area 


SLI 


11 


Length 



Operation 


Address 


Flags 


Tp-Op Code 


Count 


1. Disable 





SLI 


21 


1 



The Disable command breaks the switched 
line connection. 
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CHANNEL PROGRAMS FOR IBM 2 848 - 2260 REMOTE 
LINES 



Read Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


16 


(1 STX and 15 circle Cs) 










2. Write polling characters 


List 


CD 


03 


2 


3. Write READ Ml code 


Table 


CC, SLI 


04 


1 


4. Read response 


Area 


CD 


05 


2 


5. Read data 


Area +2 


SLI 


11 


Length-2 



Initiated by the read/write routine, the 
read initial channel program places the 
line in control mode and polls a terminal 
with a two character code. For the 2260 
devices, the polling characters specify a 
general poll of the display control, a 
specific poll of a display station , or a 
request of a printer status. After the 
polling characters are sent, the special 
READ MI code is sent to inform the 2848 
that the CPU wants a message. 

Specific Poll of a Display Station : On 
positive response (STX) , chains the "read 
response" to read the message. On negative 
response (EOT) , an interruption occurs. 
BTAM detects the "polling restart TP-Cp 
Code," initializes the channel program to 
poll the next entry within the list, and 
return control to the supervisor. 

Request of a Printer Status : If the 
printer is ready and the buffer is empty, a 
reservation is set on the printer buffer 
which prevents transmission of messages 
from the display stations to the printer 
buffer. If a message is received 
indicating these conditions, the "read 
response" chains to be "read data" CCW. 
The problem program issues a WRITE Continue 
to print the message. The next EOT resets 
the reservation condition. 

A negative response is either NAK, which 
indicates the printer is not ready, or EOT, 
which indicates the printer is ready but 
the buffer is not empty. If a NAK response 
is received, the problem program may send a 
message to an operator. Both negative 
responses set the printer request condition 
which causes the Display Control, upon 
receipt of a General Poll, to sense if the 
printer is in a ready condition and if the 
buffer is empty. 

It is advisable for the user to set the 
End-of-Li*st bit on in the printer. If it 
is not on, the information EOT or NAK is 



not posted and ETAM will restart polling 
and return control to the supervisor. 

General Pell of a Display Ccntrc l : The 
polling list must specify a general pell, 
with the secend byte a hexadecimal FF. If 
the printer has a status pending as a 
result of a previous request (printer 
status or VvRITE Initial) , this message will 
be transmitted and the "read response" CCVi 
will chain tc the read data CCVi. 

If the printer is net ready, the Display 
Stations are scanned for a message. If a 
message is pending, it is sent. If there 
is no message waiting for transmission, a 
negative response EOT is received. The 
channel program is interrupted; # ETAM 
detects the "polling restart TP-Cp cede," 
updates the channel program, and returns 
control tc the supervisor. 



Read Continue Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write ACK 
2. Read data 


Table 
Area 


CC,SLI 
SLI 


02 
11 


1 
Length 



The read continue channel program sends 
a positive response ACK and reads the 
message. If the previous operation was a 
specific poll of a display station, an ECT 
will be returned which ends the operation. 
If the previous operation was a general 
poll, a message (if one is sending) will be 
received; otherwise an ECT is received. 



Read Repeat Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write NAK 
2. Read data 


Table 
Area 


CC,SLI 
SLI 


02 
11 


1 
Length 



The read repeat channel program sends a 
negative response NAK and reads the data. 



Read Skip Channel Prcgram 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Read Skip 


Zero 


SLI, Skip 


22 


Length 



Initiated by the read/write routine, the 
read skip channel program read the data in 
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to clear the line but it is not read into 
storage. 



Read Buffer Channel Program 



Ope rot ion 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


16 


(1 STX and 15 circle Cs) 










2. Write polling characters 


List 


CD 


03 


2 


3. Write READ BUFFER code 


Table 


CC, SLI 


04 


1 


4. Read response 


Area 


CD 


05 


2 


5. Read data 


Area+2 


SLI 


11 


Length-2 



The read buffer channel program is used 
for special applications, primarily 
diagnostic. It places the line in control 
mode, sends the polling characters, and 
sends the READ BUFFER code to indicate the 
type of operation. The entire display 
station buffer is then read into the 
message area. A WRITE Erase 
macro-instruction should be issued 
following the READ Buffer. This will erase 
the CRT and the message (s) from the screen. 



Reset Following a Read 



The write initial channel prograir is for 
either the printer cr the display station. 
The channel program places the line in 
control ircde, sends the addressing 
characters and sends the WRITE cede. If a 
printer is addressed, the "read response" 
CCW reads the addressing seguence response. 
If either an ECT or a NAK (negative 
responses) is received, there is an 
interrupt. The ECT indicates the printer 
is net ready, and the NAK indicates the 
printer is ready but that the buffer is net 
empty. Either of these sets is a printer 
reguest. 

If the response is positive (ACK) which 
indicates that the printer is ready and the 
buffer is empty, the "read response" CCW 
command chains to send the SIX (start cf 
text character) and then send the data. If 
a transmission error occurs, the cperaticn 
is stopped and the printer buffer is 
cleared. (Retransmission may be retried 
with a WRITE Continue macro-instruction.) 

If a display station is addressed, the 
"read response" CCW reads the addressing 
seguence response which is normally 
positive (ACK) chains to read the data. If 
a transmission error occurs, the user may 
retry by issuing a WRITE Continue but the 
erroneous message will net be cleared. The 
user may issue a WRITE Erase tc resend the 
same message, or a READ BUFFER and Write 
Erase if several messages were displayed. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write STX and EOT 
sequence (3 circle C s) 


Table 


SLI 


21 


4 



Write at Line Address Channel Program 



If reset was specified by READ T1R, TTR, 
TPR, or TBR, the reset command will be 
added to the end of the corresponding" basic 
channel program. The reset will be 
performed only if the basic channel program 
completes without error. 



Write Initial Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 


Table 


CD 


02 


16 


(1 STX and 15 circle Cs) 










2. Write addressing characters 


List 


CD 


03 


2 


3. Write WRITE code 


Table 


CC, SLI 


04 


1 


4. Read response 


Respn 


CC 


06 


1 


5. Write STX 


Table 


CD 


08 


1 


6. Write data 


Area 


CC, SLI 


11 


Length 


7. Read response to Text 


Respn+1 




20 


' 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(1 STX and 15 circle Cs) 


Table 


CD 


02 


16 


2. Write addressing characters 


List 


CD 


03 


2 


3. Write WRITE LINE code 


Table 


CC, SLI 


04 


1 


4. Read response 


Respn 


CC 


06 


I 


5. Write STX 


Table 


CD 


08 


1 


6. Write at line 


Area 


CC, SLI 


10 


Length 


7. Read response to text 


Respn+1 




20 


1 



The write at line address channel 
program places the line in control mode, 
addresses a terminal with a twe character 
code, and sends the WRITE LINE cede to 
inlicate the operation to the 2848. The 
response to addressing is read, if it is 
positive, the read response chains tc write 
the SIX character and the data. If the 
response is negative, the channel program 
is terminated. The cursor is positioned on 
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a specified line and the characters are 
displayed from that point. The response is 
read into the second byte of the response 
field in the DECB. If a transmission error 
occurred , the user may retry sending the 
message with a WRITE Continue. The data 
will be displayed starting at the same 
line. 



Write Erase Channel Program 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write deselect characters 


Table 


CD 


02 


16 


(1 STX and 15 circle Cs) 










2. Write addressing characters 


List 


CD 


03 


2 


3. Write ERASE Code 


Table 


CC, SLI 


04 


1 


4. Read response 


Respn 


CC 


06 


1 


5. Write STX 


Table 


CD 


08 


1 


6. Write data 


Area 


CC, SLI 


11 


Length 


7. Read response to text 


Respn+1 




20 


1 



The write erase channel program places 
the line in control mode, addresses a 
terminal with the two character code, and 
sends the special code ERASE. This 
operation is to erase the CRT and any 
message on the display screen starting in 
the upper left-hand corner. The response 
to addressing is read in the first Dyte of 
the response field in the DECB (DECRESPN) . 
If a negative response is received, the 
channel program is terminated. 

If a positive response is received, the 
"read response" is chained to the write STX 
character followed by data. The response 
to text is read into the second byte of the 
DECB response field. If a transmission 
error occurred, the user may issue another 
WRITE Erase macro-instruction to send the 
same message. 



Write Continue Channel Program 



The write continue channel program sends 
a positive response STX followed by the data 
and reads the response into the second byte 
of the DECB response field (DECRESPN+1) . 



Write Positive Acknowledge Channel Proqram 




Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Write STX 
and deselect characters 
(3 circle C s) 


Table 


SLI 


21 


4 



The write positive acknowledge channel 
program sends a positive response STX and 
three circle Cs to place the line in 
control irode. 



Write Neqative Acknowle 


dqe Channel Proqram 




Operation 


Address 


Flags 


TP-Op Code 


Count 


1 .Write deselect characters 
(3 circle C s) 


Table 


SLI 


21 


3 



The write negative acknowledge channel 
program turns the terminal motors off. 
There is no positive response character 
sent. 



Reset Followed by a Write 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write deselect characters 
(STX and 3 circle Cs) 


Table 


SLI 


21 


4 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Write STX 


Table 


CD 


08 


1 


. 2. Write data 


Area 


CC, SLI 


11 


Length 


3. Read response to text 


Respn+1 




20 


1 



If reset is specified by WHITE TIR, TLR # 
TSR, or TTR, the reset command is added to 
the corresponding basic channel prcgrair. 
It sends three circle Cs to turn the 
terminal irotcrs off. 
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CHANNEL PROGRAMS EMPLOYING START-STOP AUTO POLL 



The only operation types for which Auto Poll requires the building of 
special channel programs are those Read macro instructions which write 
polling characters. These are indicated by X in the following table. 



Read j 

Operation | Devices 
(. T x r 1 T T 1 







I * 


Name | 

L. 


Code 


| 1030 
_X— 


Initial | 


TI 


T 

1 x 

1 


Continue j 


TT 


1 

1 x 

i 


Repeat | 


TP 


1 

1 x 



— + i 




I * 

j 1050 

-+- 
I x 



| *Reset Option is allowed. j 

L J 



All other operation types will result in channel programs identical 
to the current ones. 

The form of the channel programs is not device- dependent, hence they 
are presented by op-type-code only. 



READ Initial (TI) with SSALST 



- T T 

| Address | Flags 
_ + + 



"T 

| Count 
"j. 



j Operation 



1. 


Write EOT-Sequence 


j table 


2. 


Poll 


(any ent 


3. 


NOP 


|Poll 
j command 


4- 


Read Index 


jarea 


5. 


Read Text 


|area+2 

h 


6. 


Write (5)©©© 


| table 



j TP-OP Code 
-+ 



— + — 



CC,SLI 


02 


CC f SLI 


03 


SLI 


09 


CD 


0A 


(CO, SLI 

_ _. . . j 


11 


SLI 


21 



3 

k*n 

1 



length- 2 



-X x 



U 



The line is placed in control mode by sending the EOT-Sequence of 
three circle Cs. For Poll the count of k*n is figured as follows: k=2 
for IBM 1030 and 3 for other devices, n=number of list entries between 
the starting entry and the first skipped entry or the end of the list. 
The NOP is the last conwrand executed on a negative response to polling 
at the end of the list. Upon a positive response to polling, the Read 
Index comirand is executed after the Poll, bringing into f area' the index 
byte (corresponding to the responding terminal), plus the first byte of 
data (text). The Read Text command reads the remaining text of the 
message. The length operand in the READ macro instruction must allow 
one extra byte for receiving the index byte. The CC flag is set only if 
command 6 is added. 
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Command 6, the reset, will be performed only in the event of a 
successful read operation.. Reset command (TIR) is not allowed for IBM 
2740 with Station Control, but it is allowed for the other terminals. 



READ Initial (TI) with SSAWLST 













r 

i 

L 


Operation 


| Address | Flags 
_i i 


|TP-OP Code (Count | 
4— J- J 


r 


Write EOT Sequence 


| table |CC,SLI 


T 

J 02 


T 1 

|3 j 


|2. 


Poll 


jany entry in list|CC,SLI 


| 03 


|k*n | 


|3. 


TIC 


|2nd Poll command JSLI 


J 09 


U 1 


1**- 


TIC 


|Read Index j 
| command | 






|5. 


Poll 


| first entry j 

jin list |CC,SLI 


|03 


|k*n | 


|6. 


TIC 


|2nd Poll command |SLI 


| 09 


|1 1 


I?. 


Read Index 


jarea |CD 


|0A 


12 | 


|8. 


Read Text 


|area+2 | (CC) # SLIJ11 


| length- 2 | 


1*- 

L 


write (£)©©© 


(table |SLI 

-J X 


H- 

121 


|4 I 
± j 



The line is placed in control mode by sending the EOT-Sequence of 
three circle Cs. For Poll the count of k*n is figured as follows: k=2 
for IBM 1030 and 3 for other devices, n=number of entries between the 
starting entry and the first skipped entry or the end of the list. On a 
negative response to polling at the end of the list, command 3 (TIC) is 
executed to start command 5 (Poll). On a positive response to polling, 
command 4 (TIC) is executed to start the Read Index command. If either 
Poll command (2 or 5) terminates with negative response at end of list, 
command 5 (Poll) restarts polling at the beginning of the list. For 
command 5 the count is figured as follows: k=2 for the IBM 1030 and 3 
for all other devices, n=the total number of active entries in the 
polling list. On a negative response to polling at the end of the list 
for command 5, this TIC (command 6) is executed to restart the previous 
(2nd) Poll command. On a positive response to polling, the Read Index 
command reads the list entry index byte and the first byte of text into 
the message area and chains to command 8. The Read Text command causes 
the remainder of the text to be read into the message area. 

Reset command (TIR) is not allowed for IBM 2740 with Station Control,, 
but it is allowed for the other terminals. The reset command will be be 
performed only in the event of a successful read operation. 

The two TIC commands (3 and 6) are changed to NOPs if a RESETPL macro 
instruction (2nd operand blank or specified as POLLING) is issued. 
Thus, RESETPL will cause non-productive polling to terminate at the end 
of the list if Auto Poll is being used, whereas* without Auto Poll, 
RESETPL causes polling to terminate after the current poll. 
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READ Continue (TT) 



j Operation 

| 1, Write Positive 
| Response and 
I EOT- Sequence 

I 

J 2. See the discussion 

L : 



T ' T T ' 1 

Address | Flags | TP-OP Code | Count | 



table 



CC # SLI 



02 



.X 



X- 



A positive response circle Y and EOT-Sequence of 3 circle Cs is sent 
to the terminal . The remainder of the channel program is identical to 
READ TI (either form), beginning with the second command. 



READ Repeat (TP) 



| Operation 
h 



1. Write Negative 
| Response and | table | CC t SLI 
| EOT-Sequence 

I 

| 2. See the discussion | | 

i ; i ± 



T T T 

Address | Flags | TP-OP Code | Count 



— 1 
! 



02 



A negative response circle N and EOT-Sequence of 3 circle Cs is sent 
to the terminal. The remainder of the channel program is identical to 
READ TI (either form) , beginning with the second command. 
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IODEVICE 


I ODE VICE 


Module 


UNIT Operand 


IGG019M5 


BSC1 


IGG019M6 


BSC2 


IGG019PC 


BSC3 



BINARY SYNCHRONOUS COMMUNICATIONS CHANNEL PROGRAMS 



This chapter gives the channel programs corresponding to the Read and 
Write operations that may be used for communications lines to which are 
connected stations employing binary synchronous communications (BSC) 
techniques, Channel programs are grouped by type of line configuration. 
The three types of configuration, the name of the device I/O module 
containing the model channel commands , and the value coded in the UNIT 
operand of the IODEVICE macro instruction are as follows: 

Conf igur at ion 

Nonswitched point-to-point 
Switched point-to-point 
Nonswitched Multipoint 

For any given line configuration, the channel programs may be used 
for any of the types of remote BSC stations that can be connected to 
that line configuration. 



NONSWITCHED POINT-TO-POINT LINE 



READ CHANNEL PROGRAMS 



Eight options are available for the READ macro instruction. The 
operation codes and corresponding options are: 

TI - Read Initial 

TT - Read Continue 

TTL - Read Continue with Leading Graphics 

TP - Read Repeat 

TPL - Read Repeat with Leading Graphics 

TIQ - Read Initial Inquiry 

TQ - Read Inquiry 

TRV - Read Interrupt 

The channel programs for these options are as follows. 



Read Initial (TI) 

Read TI monitors the line for an incoming character, which should always 
be an ENQ, sends a positive response, and receives a message block from 
a remote station. 
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T T T 1 

Address | Flags | TP-OP Code j Count | 
| CC,SLI | 01 \ 1 



j Operation 
!• Prepare 



2, Read ENQ 



3. Write response 



<*• Read text 



Response 



Table 



Area 



SLI 



CC* SLI 



SLI 



OB 



08 



11 






Length 



j 



1. This command causes the data adapter to monitor the line for an 
incoming character, 

2. An ENQ character is expected from the remote station, indicating 
that it is ready to transmit. 

3. An ACK-0 sequence is sent to the remote station* to indicate that 
the central computer is ready to receive. 



4. A message block is read from the remote station. 



Read Continue (TT) 

Read TT is for use following successful receipt of a message block from 
a remote station. It sends a positive response and receives another 
message block from the same station. 

j Operation j Address j Flags j TP-OP Code J Count j 

,. + + + + 1 

j 1. Write ACK-0 or j Table j CC # SLI j 08 I 2 | 

I ACK-1 III II 

I III II 

j 2. Read text | Area ] SLI j 11 J Length | 

L J X JL i J 

1. A positive response to text (ACK-0 or ACK-1) is sent to the remote 
station. 

2. A message block is read from the remote station. 



Read Continue with Leading Graphics (TTL) 



Read TTL "is an extension of the Read Continue channel program and is 
used similarly. It is for use where the positive response is to be 
preceded by user-specified graphic characters. 
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j Operation 



j Address j Flags j TP-OP Code j Count 



1. Write graphics 

2. Write ACK-0 or 
ACK-1 

3. Read Text 



Area 
Table 

Area 



CD 

CC € SLI 



SLI 
JL 



01 
08 

11 



Length 
2 

Length 



1. One to seven graphics are sent to the remote station. 

2. A positive response to text (ACK-0 or ACK-1) is sent to the remote 
station. 

3. A message block is read from the remote station. 



Read Repeat (TP) 

Read TP is for use following unsuccessful receipt of a message block 
from a remote station. It sends a negative response and reads a message 
block from the same station. The station should react to the negative 
response by resending the same message block that elicited the negative 
response. 

r T T T T 1 

| Operation | Address | Flags | TP-OP Code j Count | 

| 1. Write NAK | Table | CC,SLI | 08 \ 1 | 

I III II 

| 2. Read text | Area | SLI | 11 | Length | 

L X X X X J 



1. A NAK character is sent to the remote station. 

2. The previous message block is reread from the remote station. 



Read Repeat with Leading Graphics (TPL) 



Read TPL is an extension of the Read Repeat channel program and is used 
similarly. It is for use where the negative response is to be preceded 
by user-specified graphic characters. 



r 

| Operation 

,. 

| 1. Write graphics 


t 

| Address 
^ 

| Area 


-T 

| Flags 

-+ 

j CD 
1 


_ T 

| TP-OP 

-X 

1 01 


Code 


— T- 

1 
"4- 


Count 
Length 


-1 

I 

H 


| 2. Write NAK 


j Table 


1 

| CC,SLI 

i 


| 08 






1 




| 3. Read text 

L 


j Area 
x 


i 

| SLI 
-X 


1 11 

_x 




X- 


Length 


-j 



1. One to seven graphics are sent to the remote station. 

2. A NAK character is sent to the remote station. 
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The previous message block is reread from the remote station. 



Read Initial Inquiry (TIQ) 



Read TIQ monitors the line for an incoming character, which should be an 
ENQ, and receives it in the DECRESPN field • This channel program is for 
use where character phase has not already been established (if it has 
already been established when the channel program begins execution, the 
Prepare command ends immediately), 

r T T T T 1 

| Operation | Address | Flags | TP-OP Code | Count | 

|. ^ + + x -J 

j 1. Prepare j j CC, SLI j 01 j 1 j 

I III II 

| 2. Read ENQ j Response) SLI | OB I 2 j 

L J X X X J 



1. This command causes the data adapter to monitor the line for an 
incoming character, 

2, An ENQ character is expected from the remote station, indicating 
that it is ready to transmit. 



Read Inquiry (TQ) 



Read TQ receives an incoming character in the DECRESPN field. This 
channel program is for use when character phase is already established 
and an ENQ is expected. 

r T T T ' T " 1 

| Operation | Address | Flags | TP-OP Code | Count J 
|. + + + x 4 

j 1. Read ENQ | Response] SLI | OB I 2 | 

L X X X A J 



1, An ENQ character is expected from the remote station. 



Read Interrupt (TRV) 



Read TRV sends an RVI (Reverse interrupt) sequence and receives text 
from the remote station. This channel program is for use where the 
preceding message block from the station was received without error, but 
the central computer wishes temporarily to stop receiving message text. 
The remote station may continue sending message text, or it may send 
EOT, signifying that it has finished sending. 

r T T — : T T 1 

| Operation | Address | Flags | TP-OP Code | Count | 
,. + + + x 4 

| 1. Write RVI sequence j Table j CC,SLI j 08 j | 2 j 

I III 11 

| 2. Read Text j Area j SLI j 11 j Length j 

L X X . X X J 



A reverse interrupt (RVI) sequence is sent to the remote station. 
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which treats it as though it were the correct alternating positive 
acknowledgment (ACK-0 or ACK-1). 

A message block or EOT is received from the remote station. 



WRITE CHANNEL PROGRAMS 



Seventeen options are available for the WRITE macro instruction, 
operation codes and corresponding options are: 



The 



TI 


- 


Write 


Initial 


TIR 


- 


Write 


Initial and Reset 


TIX 


- 


Write 


Initial Transparent 


TIXR 


- 


Write 


Initial Transparent and Reset 


TIE 


- 


Write 


Initial Transparent Block 


TIV 


- 


Write 


Initial Conversational 


TIVX 


- 


Write 


Initial Conversational Transparent 


TT 


- 


Write 


Cont inue 


TTR 


- 


Write 


Continue and Reset 


TTX 


- 


Write 


Continue Transparent 


TTXR 


- 


Write 


Continue Transparent and Reset 


TTE 


- 


Write 


Continue Transparent Block 


TTV 


- 


Write 


Continue Conversational 


TTVX 


- 


Write 


Continue Conversational Transparent 


TQ 


- 


Write 


Inquiry 


TR 


- 


Write 


Reset 


TW 


*" 


Write 


Wait-Bef ore-Transmit 


Write Initial (TI) 




Write Initial and Reset (TIR) 



Write TI (or TIR) bids for use of the line by sending an ENQ to the 
remote station; then upon receiving a positive response, sends a message 
block and receives a response to text. Write TIR sends an EOT to 
relinquish use of the line if a positive response to text is received. 



r 

| Operation 

L . 


-- "1 "T" 

| Address | 
^ + . 

| Table | 


Flags 
CC # SLI 


1 
-+- 


TP-OP 
03 


Code 


— T - 

1 


Count 

1 


1 

H 


r — 

| 1. Write ENQ 


| 2. Read response 


| Response | 


SLI 




oc 






2 




| 3. Write text 


| Area j 


CC.SLI 




11 






Length 




1 1. Read response 


| Response) 


SLI 




25 






2 




| 5. Write EOT 
j (TIR only) 


| Table j 

L , , ,- , 1. 


SLI 


— L- 


21 




— A_ 


1 


-i 



1- An ENQ character is sent to the remote station to bid for use of the 
line, i.e. f the central computer wishes to transmit. 

2. A response to the ENQ is read from the remote station. If the 
response is ACK-0 „ the channel program is restarted at the next 
command. If the response is not ACK-0 , the operation is posted 
complete, with or without error. 

3. A message block is sent to the remote station. 
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4. A response to text is read from the remote station? if it is not the 
expected response (ACK-0 or ACK-1) # the condition is indicated in 
the DECB and the operation is posted complete (regardless of whether 
the Reset option was specified) . 

5, The EOT character informs the remote station that the central 
computer is relinquishing control of the line* 

Write Initial Transparent (TIX) 

Write Initial Transparent and Reset (TIXR) 

Write TIX (or TIXR) bids for use of the line by sending an ENQ to the 
remote station; then, upon receiving a positive response, sends a 
transparent message block and receives a response to text. Write TIXR 
sends an EOT to relinquish use of the line if a positive response to 
text is received. 



I Operation j Address j Flags j TP-OP Code j Count 



1. Write ENQ 

2. Read response 

3. Write text 

4. Write DLE ETX 

5. Read response 

6. Write EOT 

(TIXR only) 



Table 

Response 

Area 

Table 

Response 

Table 



CC, SLI 
SLI 

CC, SLI 
CC, SLI 
SLI 
SLI 



03 
0C 
11 
13 
25 
21 



1 

2 

Length 

2 

2 

1 



1. An ENQ character is sent to the remote station to bid for use of the 
line, i.e., the central computer wishes to transmit. 

2. A response to the ENQ is read from the remote station. If the 
response is ACK-0, the channel program is restarted at the next 
command. If the response is not ACK-0, the operation is posted 
complete, with or without error. 

3. A message block is sent to the remote station, (Note: The length 
specified should not include the ETX that might have been placed in 
the buffer during a previous operation.) 

4. The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the remote station. 

5. A response to text is read from the remote station; if it is not the 
expected response (ACK-0 or ACK-D* the condition is indicated in 
the DECE and the operation is posted complete (regardless of whether 
the Reset option was specified) . 

6. The EOT character informs the remote station that the central 
computer is relinquishing control of the line. 



Write Initial Transparent Block (TIE) 



Write TIE functions identically to Write Initial Transparent (TIX) 
except that the fourth command sends a DLE ETB sequence instead of a DLE 
ETX sequence; only the ETB appears in the input buffer of the remote 
station. 
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Write Initial Conversational (TIV) 



Write TIV bids for use of the line by sending an ENQ to the remote 
station; then, upon receiving a positive response, sends a message block 
and receives a response to text followed by a message block (if any). 



T T T T 1 

| Address | Flags | TP-OP Code | Count | 



j Operation 

1. Write ENQ 

2. Read ACK-0 

3. Write text 

4. Read response 

5. Read text 



| Table 


CC, SLI 


03 


1 | 


| Response 


SLI 


OC 


2 I 


| Area 


CC, SLI 


11 


Length | 


| Area 


CD, SLI 


25 


20 | 


| Area+20 


SLI 


11 


Length j 
-20 | 



1. An ENQ character is sent to the remote station to bid for use of the 
line, i.e., the central computer wishes to transmit. 

2. A response to the ENQ is read from the remote station. If the 
response is ACK-0, the channel program is restarted at the next 
command. If the response is not ACK-0, the operation is posted 
complete, with or without error. 

3. A message block is sent to the remote station. 

4. A response to text is read from the remote station. If the response 
is message text exceeding 20 characters, this command is 
data-chained to the next command. Otherwise, the operation is 
posted complete, with or without error. 

5. The remainder of the message block is read from the remote station. 



Write Initial Conversational Transparent (TIVX) 



Write TIVX bids for use of the line by sending an ENQ to the remote 
station; then, upon receiving a positive response, sends a transparent 
message block and receives from the remote station a response to text 
followed by a message block (if any). 



r 1 t t T~ 

| Operation | Address | Flags | TP-OP Code | Count | 

1. Write ENQ 

2. Read response 

3. Write text 

4. Write DLE ETX 

5. Read response 

6. Read text 



| Table 


CC„ SLI 


03 


j Response 


SLI 


OC 


j Area 


CC W SLI 


11 


j Table 


CC„ SLI 


13 


j Area 


CD„ SLI 


25 


| Area+20 


SLI 


11 
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1. An ENQ character is sent to the remote station to bid for use of the 
line, i.e., the central computer wishes to transmit. 

2. A response to the ENQ is read from the remote station. If the 
response is ACK-0, the channel program is restarted at the next 
command. If the response is not ACK-0, the operation is posted 
complete, with or without error. 

3. A message block is sent to the remote station* (Note: The length 
specified should not include the ETX that might have been placed in 
the buffer during a previous operation.) 

4. The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the remote station. 

5. A response to text is read from the remote station. If the response 
is message text exceeding 20 characters* this command is 
data-chained to the next command. Otherwise, the operation is 
posted complete, with or without error. 

6. The remainder of the message block is read from the remote station. 



Write Continue (TT) 

Write Continue and Reset (TTR) 



Write TT and TTR are for use after initial transmission has occurred, to 
send another message block and receive a response from the remote 
station. Write TTR sends an EOT to relinquish use of the line if a 
positive response to text is received. 



r 

| Operation 

F 

| 1. Write text 




■ '"T"""" "T 

| Address | Flags 
._+ + 

1 Area | CC,SLI 
i i 


T "" 

| TP-OP Code 
„ + 

1 H 


1 


Count 
Length 


1 

H 


I 2. Read response 




1 1 

| Response) SLI 

i i 


1 25 




2 




| 3. Write EOT 
| (TTR only) 

L 




1 1 

J Table | SLI 

1 1 

. , A. - ™ l , ... 


1 21 

__X - -p 


.X 


1 


j 


1. A message block 


is 


sent to the remote 


station* 








2. A response to text 


is read from the remote station? if 


it 


is not t 


he 



3. 



expected response (ACK-0 or ACK-D* the condition is indicated in 
the DECB and the operation is posted complete (regardless of whether 
the Reset option was specified) . 

The EOT character informs the remote station that the central 
computer is relinquishing control of the line. 



Write Continue Transparent (TTX) 

Write Continue Transparent and Reset (TTXR) 



Write TTX and TTXR are for use after initial transmission has occurred* 
to send a transparent messge block and receive a response to the text 
from the remote station. Write TTXR sends an EOT to relinquish use of 
the line if a positive response to text is received. 
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"T T T T 

| Address | Flags | TP-OP Code ] Count 



Operation 



1. Write text 

2. Write DLE ETX 

3. Read response 

4. Write EOT 

(TTXR only) 



| Area 


CC, SLI 


11 


Length J 


| Table 


CC„ SLI 


13 


2 J 


I Response 


SLI 


25 


2 1 


1 Table 


SLI 


21 


1 | 



A message block is sent to the remote station. (Note: The length 
specified should not include the ETX that might have been placed in 
the buffer during a previous operation.) 

The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the remote station. 

A response to text is read from the remote station; if it is not the 
expected response (ACK-0 or ACK-1), the condition is indicated in 
the DECB and the operation is posted complete (regardless of whether 
the Reset option was specified) . 

The EOT character informs the remote station that the central 
computer is relinquishing control of the line. 



Write Continue Transparent Block (TTE) 



Write TTE functions identically to Write Continue Transparent (TTX) 
except that the second command sends a DLE ETB sequence instead of a DLE 
ETX sequence; only the ETB appears in the input buffer of the remote 
station. 



Write Continue Conversational (TTV) 



Write TTV is for use after initial transmission has occurred, to send 
another message block and receive from the remote station a response to 
text followed by a message block (if any). 



- T T T T - 

| Address | Flags | TP-OP Code | 
. + x + + - 



| Operation 



|. + x + x 

1. Write text 

2. Read response 

3. Read text 



| Area 


CC, SLI 


11 


| Area 


CD, SLI 


25 


I Area+20 


SLI 


11 



Length 
-20 

L X X X X J 



Count 
Length 
20 



1. A message block is sent to the remote station- 

2. A response to text is read from the remote station. If the response 
is message text exceeding 20 characters* this command is 
data-chained to the next command. Otherwise, the operation is 
posted complete, with or without error. 
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3. The remainder of the message block is read from the remote station. 



Write Continue Conversational Transparent (TTVX) 



Write TTVX is for use after initial transmission has occurred, to send a 
transparent message block and receive from the remote station a response 
to text followed by a message block (if any) . 



j Operation 



■T T T T 1 

| Address ] Flags | TP-OP Code ] Count 




1. Write text 

2. Write DLE ETX 

3. Read response 

4. Read text 



| Area 


CC, SLI 


11 


| Table 


CC, SLI 


13 


| Area 


CD, SLI 


25 


1 Area+20 


SLI 


11 



1. A message block is sent to the remote station, (Note: The length 
specified should not include the ETX that might have been placed in 
the buffer during a previous operation.) 

2. The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the remote station, 

3. A response to text is read from the remote station. If the response 
is message text exceeding 20 characters, this command is 
data-chained to the next command, otherwise, the operation is 
posted complete, with or without error. 

4. The remainder of the message block is read from the remote station. 



Write Inquiry (TQ) 



Write TQ sends an ENQ and receives a response. This channel program is 
used to solicit a response from a remote station when the previous 
response was invalid or an expected response was not received. 



Operation 



| 1. Write ENQ 

I 

| 2. Read response 

i 

' 3. Read text 



-T T 

| Address | Flags 
H + 

j CC,SLI 

I 

SLI, CD 



| Table 

I I 

j Area j 

I Area+20 I SLI 

. i l 



j TP-OP Code 



03 
25 

11 



j Count 



J 



1 
20 
Length- 20 



1. The ENQ character requests the remote station to resend its last 
response. 
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2. A response to the ENQ is read from the remote station. The re- 
sponse is read into the user-supplied input area or the DECRESPN 
area if count is equal to or less than 2. If the response is 
message text exceeding 20 characters, this command is data-chained 
to the next command. Otherwise , the operation is posted complete , 
with or without error. 

3. The remainder of the message block is read from the remote station. 
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Write Reset (TR) 

Write TR is for use when the central computer wishes to relinquish use 
of the line. 

r t t t t 1 

| Operation | Address | Flags | TP-OP Code | Count | 

| 1. Write EOT | Table | SLI I 21 | 1 | 

L J ± X X J 



1, The EOT character informs the remote station that the central 
computer is relinquishing control of the line*. 



Write Wait-Before-Transmit (TW) 

Write TW is for use in place of a Read channel program that begins by 
sending a positive response to text (e.g. Read TT) . Write TW sends a 
WACK sequence, which the remote station treats as if it were the usual 
alternating acknowledgment (ACK-0 or ACK-1) ; the remote station responds 
to the WACK by sending an ENQ instead of another message block. This 
channel program may be reexecuted for as long as necessary for the 
central computer to delay receiving text. 



r t t t t 1 

| Operation | Address | Flags | TP-OP Code | Count ] 

| 1. Write WACK | Table | CC,SLI | 01 I 2 



j 2. Prepare j Zero j CC,SLI j 01 \ 1 

I 111] 

I 3. Read ENQ I Response I SLI 'OB \ 2 



1 . The WACK sequence informs the remote station that the central 
computer is temporarily not ready to continue receiving. 

2. This command causes the data adapter to monitor the line for an 
incoming character. 

3. An ENQ character is expected from the remote station. 



._! 
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SWITCHED POINT-TO-POINT LINE 



READ CHANNEL PROGRAMS 



Nine options are available for the READ macro instruction. The 
operation codes and corresponding options are: 

TI - Read Initial 

TC - Read Connect 

TCW - Read Connect with Tone 

TT - Read Continue 

TTL - Read Continue with Leading Graphics 

TP - Read Repeat 

TPL - Read Repeat with Leading Graphics 

TQ - Read Inquiry 

TRV - Read Interrupt 

The channel programs for these options are as follows. 

Read Initial (TI) (Using Automatic Answering List) 

Read TI f when used with an automatic answering list of the BSCLST or 
DIALST format, causes a call from a remote station to be answered, 
identification sequences exchanged, and a message block received. Use 
of either or both identification sequences is optional,, but the ENQ 
character must be received and the ACK-0 sequence must be sent. 



| Operation 



T T T T 1 

| Address | Flags | TP-OP Code | Count j 



1. Enable 





CC, SLI 


01 




1 1 


2. Read ID ENQ 


List 


SLI 


07 


(OB)* 


List ] 


3. Write ID ACK-0 


List 


CC„ SLI 


03 




List | 


4. Read text 


Area 


SLI 


11 




Length ] 



*TP-Op Code for Dial List 

1. The Enable command conditions the data adapter to answer calls from 
a remote station. 

2. The identification sequence received from the remote station is 
compared with the expected sequence contained in the terminal list. 
If the two sequences do not match, the operation is posted 
complete-with-error. (The ID sequence is optional; the ENQ must 
always be present.) 

3. The identification sequence of the central computer, followed by 
ACK-0 , is sent to the remote station. (The ID sequence is optional; 
the ACK-0 must always be present.) 

4. A message block is read from the remote station. 



Read Initial (TI) (Using Automatic Calling List) 



Read TI f when used with an automatic calling list of the BSCLST or 
DIALST format, dials the remote station whose telephone number appears 
in the list, exchanges identification sequences with it, and receives a 
message block. 
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, — -, T T T -, 

Operation | Address | Flags | TP-OP Code J Count | 

List 



1. Dial 

2. Write ID ENQ 

3. Read ID ACK-0 

4. Write EOT 

5. Read ENQ 

6. Write ACK-0 

7. Read text 
*TP-Op Code for Dial List 



List 

List 

List 

Table 

Response 

Table 

Area 



CC„ SLI 

CC,SLI 

SLI 

CC, SLI 

SLI 

CC, SLI 

SLI 



01 

03 

07 (0C)* 

08 

OB 

08 

11 



List 

List 

1 

2 

2 

Length 



The telephone number of the remote station is dialed. 



2. The identification sequence of the central computer , followed by 
ENQ, is sent to the remote station. (The ID sequence is optional; 
the ENQ must always be present,) 

3. The identification sequence (followed by ACK-0) is received from the 
remote station and is compared with the expected sequence contained 
in the terminal list. If the two sequences do not match, the 
operation is posted complete-with-error. (The ID sequence is 
optional; the ACK-0 must always be present.) 

4. The EOT character informs the remote station that the central 
computer is relinquishing control of the line. 

5. An ENQ character is expected from the remote station, indicating 
that it is ready to transmit. 

6. An ACK-0 sequence is sent to the remote station, to indicate that 
the central computer is ready to receive. 

7. A message block is read from the remote station. 



Read Initial (TI) (Using Manual Answering List) 



Read TI, when used with a manual answering list of the WTLIST or BSCLST 
format, causes a call from a remote station to be answered, a data tone 
to be sent identification sequences exchanged, and a message block 
received. Use of either or both identification sequences is optional, 
but the ENQ character must be received and the ACK-0 sequence must be 
sent. 

This Read Initial option is for use when the transmission control 
unit over which calls are received is not equipped with an automatic 
answering unit. 

If the READ TI macro refers to a terminal list of the WTLIST format, 
the channel program is: 
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r T T T T 1 

| Operation | Address | Flags | TP-OP Code | Count | 

1. Enable 

2. Write tone 

3. Read ID ENQ 

4. Write ID ACK-0 

5. Read Text 



1 o 


| CC„ SLI 




01 




1 




| List 


| CC„SLI 




01 




List 




| List 


| SLI 




07 




List 




| List 


j CC W SLI 




03 




List 




| Area 


| SLI 

± 


_X- 


11 


A_. 


Length 


-J 



If the READ TI macro refers to a terminal list of the BSCLST format, 
the channel program is the same, except that the second command is 
omitted. 

1. The Enable command conditions the data adapter to answer calls from 
a remote station, 

2. A data tone is sent to inform the calling station (remote station) 
that the answering station (central computer) is in data mode. 

3. The identification sequence received from the remote station is 
compared with the expected sequence contained in the terminal list,. 
If the two sequences do not match, the operation is posted 
complete-with- error. (The ID sequence is optional; the ENQ must 
always be present.) 

4. The identification sequence of the central computer, followed by 
ACK-0, is sent to the remote station. (The ID sequence is optional; 
the ACK-0 must always be present.) 

5. A message block is read from the remote station. 



Read Connect (TO (Using Automatic Answering List - SWLST) 

Read TC establishes contact with, a remote station and performs specific 
actions based on the ID sequence , if any, received from the station. 
This channel program is for use when the expanded ID verification 
facility is to be employed, and requires a terminal list of the SWLST 
form. The possible actions that may be performed include reading a 
message block, disconnecting the line, and immediately returning control 
to the user program. 

After the sequence is received from the remote station, BTAM 
analyzes it. If the sequence matches one of authorized sequences in the 
answering list, BTAM places the address of the entry containing the 
matching ID-ENQ sequence (or ENQ alone) in the first fullword of the 
list, then examines the control byte of that list entry to determine 
what action to take. 

If the control byte value is 0, BTAM restarts the channel program at 
the third command to send the ID ACK-0 sequence (or ACK-0 alone) given 
in the list, and then reads a message block, if any. If the control 
byte value is 1, BTAM restarts the channel program at the fifth command 
to break the line connection, and then, via the TIC command, restarts 
the channel program at the Enable command. If the control byte value is 
2, BTAM immediately posts normal completion (X f 7F f ). 

If the received sequence does not match any of the authorized ID ENQ 
sequences (or ENQ alone), BTAM determines whether ENQ alone* an invalid 
sequence, or DLE EOT was received. If ENQ alone was received, BTAM 
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posts normal completion (X'7F"). If an invalid sequence was received, 
BTAM retries the Read ID ENQ command up to seven times. If all retries 
are unsuccessful, BTAM disconnects the line, turns on bit 3 of DECFLAGS, 
and posts normal completion. If a timeout occurs on the Read ID ENQ 
command, BTAM disconnects the line and restarts the channel program 
with the Enable command. 



If DLE EOT was received, BTAM turns on bit 1 of DECFLAGS and posts 
normal completion. 



T T T* 

Address | Flags | TP-OP Code | Count 



j Operation 

j. 

1. Enable 

2. Read ID ENQ 

3. Write ID ACK-0 

4. Read text 

5. Write DLE EOT 

6. Disable 

7. TIC 



-+-- 



1 

List 

List 

Length 

2 

1 

1 



1 o 


CC, SLI 


01 


j List 


SLI 


07 


| List 


CC*SLI 


03 


j Area 


SLI 


11 


j Table 


CC, SLI 


21 


1 o 


CC # SLI 


21 




SLI 


09 



1. The Enable command conditions the data adapter to answer calls from 
a remote station. 

2. The ID ENQ sequence (or ENQ alone) is received from the remote 
station and is analyzed. 

3. The ID ACK-0 sequence (or ACK-0 alone) contained in the answering 
list is sent to the remote station- 

4. A message block is read from the remote station. 

5. The DLE EOT sequence informs the remote station that the central 
computer is going to break the line connection. 

6. The Disable command breaks the line connection. 

7. This command transfers in channel to the Enable command. 



Read Connect with Tone (TCW) (Using Automatic Answering List) 

Read TCW, when used with an automatic answering list of the SWLST 
format, functions the same as Read Connect (TO, as described above* 
except that the channel program contains an added command, Write Data 
Tone characters. This operation is for use on a line equipped with an 
automatic answering unit that does not automatically send a data tone 
upon receiving a call. Upon completion of the Enable command, which 
occurs when a call is received, the channel program sends a 
user-specified character sequence that the operator at the calling 
station hears as an audible tone. 
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— T T T T -, 

I Address j Flags | TP-OP Code J Count | 



j Operation 

1. Enable 

2. Write tone 



3. Read ID ENQ 

4. Write ID ACK-0 

5. Read text 

6. Write DLE EOT 

7. Disable 

8. TIC 



1 o 


CC W SLI 


01 


1 1 


| User 


CC.SLI 


01 


Length | 


| area 








j List 


SLI 


07 


List | 


j List 


CC* SLI 


03 


List | 


j Area 


SLI 


11 


Length j 


| Table 


CC, SLI 


21 


2 | 


1 o 


CC # SLI 


21 


1 I 




SLI 


09 


1 J 



Read Continue (TT) 



Read TT is for use following successful receipt of a message block from 
a remote station. It sends a positive response and receives another 
message block from the same station, 

r t t t r 1 

| Operation | Address | Flags | TP-OP Code J Count | 

,. + + + + j 

j 1, Write ACK-0 j Table j CC*SLI j 08 I 2 ] 

I or ACK-1 III II 

I 111 II 

| 2. Read text j Area | SLI j 11 | Length j 

L X ± J. X J 



1, A positive response to text (ACK-0 or ACK-1) is sent to the remote 
station. 

2. A message block is read from the remote station. 



Read Continue with Leading Graphics (TTL) 



Read TTL is an extension of the Read Continue channel program and is 
used similarly. * It is for use where the positive response is to be 
preceded by user-specified graphic characters. 



r — 



t t t t 1 

| Address | Flags | TP-OP Code | Count | 

4 + + 4 1 

CD 



| Operation 



1. Write graphics 

2. Write ACK-0 or 

ACK-1 

3. Read text 



Area 
Table 

Area 



CC, SLI 



SLI 



01 
08 

11 



Length 
2 

Length 
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1. One to seven graphics are sent to the remote station, 

2. A positive response to text (ACK-0 or ACK-1) is sent to the remote 
station, 

3. A message block is read from the remote station. 



Read Repeat (TP) 



Read TP is for use following unsuccessful receipt of a message block 
from a remote station. It sends a negative response and reads a message 
block from the same station. The station should react to the negative 
response by resending the same message block that elicited the negative 
response. 



j Operation 

| 1. Write NAK 

I 

| 2, Read text 



T T T T 1 

| Address | Flags | TP-OP Code J Count | 

| Table | CC,SLI | 08 ] 1 ] 

III II 

| Area j SLI | 11 | Length | 
— x x x x J 



1. A NAK character is sent to the remote station, 

2. The previous message block is reread from the remote station. 

Read Repeat with Leading Graphics (TPL) 

Read TPL is an extension of the Read Repeat channel program and is used 
similarly. It is for use where the negative response is to be preceded 
by user-specified graphic characters. 



Operation 



j Address j Flags 



TP-OP Code j Count 



| 1. write graphics 

I 

| 2, Write NAK 

I 

| 3, Read text 

l 



Area 

Table 

Area 



CD 

CC, SLI 
SLI 



01 
08 
11 



Length 

1 

Length 



1. One to seven graphics are sent to the remote station. 

2. A NAK character is sent to the remote station, 

3. The previous message block is reread from the remote station. 

Read Inquiry (TQ) 

Read TQ receives an incoming character in the DECRESPN field. This 
channel program is for use when an ENQ is expected from the remote 
station, after the line connection (and character phase) have already 
been established. 
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r T T T -T 1 

| Operation | Address | Flags | TP-OP Code | Count | 

| 1» Read ENQ | Response) SLI | OB 12 | 

l J x x A J 



An ENQ character is expected from the remote station* 



Read Interrupt (TRV) 



Read TRV sends an RVI (Reverse Interrupt) sequence and receives text 
from the remote station. This channel program is for use where the 
preceding message block from the station was received without error, but 
the central computer wishes temporarily to stop receiving message text. 
The remote station may continue ssending message text w or it may send 
EOT, signifying that it has finished sending. 



r 1 t t t 1 

I Operation | Address | Flags | TP-OP Code | Count | 

| 1. write RVI sequence | Table | CC*SLI | 08 I 2 | 

I III II 

I 2. Read Text | Area | SLI j 11 J Length j 



A reverse interrupt (RVI) sequence is sent to the remote station, 
which treats it as though it were the correct alternating positive 
acknowledgment (ACK-0 or ACK-1). 

A message block or EOT is received from the remote station. 



WRITE CHANNEL PROGRAMS 



Sixteen options are available for the WRITE macro instruction, 
operation codes and the corresponding options are: 

Initial 

Initial Transparent 

Initial Transparent Block 

Initial Conversational 

Initial Conversational Transparent 

Connect 

Continue 

Continue Transparent 

Continue Transparent Block 

Continue Conversational 

Continue Conversational Transparent 

Inquiry 

Reset 

Wait-Bef ore-Transmit 

Break 

Disconnect 



The 



TI 


- 


Write 


TIX 


- 


Write 


TIE 


- 


Write 


TIV 


- 


Write 


TIVX 


- 


Write 


TC 


- 


Write 


TT 


- 


Write 


TTX 


- 


Write 


TTE 


- 


Write 


TTV 


- 


Write 


TTVX 


- 


Write 


TQ 


- 


Write 


TR 


- 


Write 


TW 


- 


Write 


TB 


- 


Write 


TD 


- 


Write 



The channel programs for these options are as follows. 
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Write Initial (TI) 



Write TI dials the remote station whose telephone number appears in the 
addressing list, exchanges identification sequences with it* sends a 
message block, and receives a response to text. 



r- 

1 

1- 


Operation 

1. Dial 

2. Write ID ENQ 

3. Read ID ACK-0 

4. Write text 


t 

| Address 
+ 

| List 

| List 
I List 
j Area 


"T" 

1 
-+- 


Flags 
CC* SLI 
CC, SLI 
SLI 
CC, SLI 


-T- 

1 
-+- 


TP-OP 
01 
03 
07 
11 


Code 


— T - 

I 


Count 
List 
List 
List 
Length 


1 

H 


L- 


5. Read response 


| Response | 

J X- 


SLI 


_X- 


25 




X- 


2 


-j 



1. The telephone number of the remote station is dialed. 

2. The identification sequence of the central computer, followed by 
ENQ, is sent to the remote station. (The ID sequence is optional; 
the ENQ must always be present.) 

3. The identification sequence (followed by ACK-0) is received from the 
remote station and is compared with the expected sequence contained 
in the terminal list. If the two sequences do not match, the 
operation is posted complete-with-error. (The ID sequence is 
optional; the ACK-0 must always be present.) 

4. A message block is sent to the remote station. 

5. A response to text is read from the remote station; if it is not the 
expected response (ACK-0 or ACK-1)„ that fact is indicated in the 
DECB. 



Write Initial Transparent (TIX) 



Write TIX dials the remote station whose telephone number appears in the 
addressing list, exchanges identification sequences with it, sends a 
transparent message block, and receives a response to text. 



Operation 

1. Dial 

2. Write ID ENQ 

3. Read ID ACK-0 

4. Write text 

5. Write DLE ETX 
6.. Read response 



T" 



1 



Address | Flags | TP-OP Code J Count | 

List 



List 

List 

List 

Area 

Table 

Response 



| CC„SLI 


01 


| CC,SLI 


03 


( SLI 


07 


| CC,SLI 


11 


| CC„SLI 


13 


| SLI 


25 



1. The telephone number of the remote station is dialed. 



List 

List 

Length 

2 

2 
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3, 



The identification sequence of the central computer, followed by 
ENQ, is sent to the remote station* (The ID sequence is optional; 
the ENQ must always be present.) 

The identification sequence (followed by ACK-0) is received from the 
remote station and is compared with the expected sequence contained 
in the terminal list. If the two sequences do not match, the 
operation is posted complete-with-error. (The ID sequence is 
optional; the ACK-0 must always be present.) 



4. A message block is sent to the remote station. (Note: The length 
specified should not include the ETX that might have been placed in 
the buffer during a previous operation.) 

5. The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the remote station. 

6. A response to text is read from the remote station; if it is not the 
expected response (ACK-0 or ACK-1), that fact is indicated in the 
DECB. 



Write Initial Transparent Block (TIE) 



Write TIE functions identically to Write Initial Transparent (TIX) 
except that the fifth command sends a DLE ETB sequence instead of a DLE 
ETX sequence; only the ETB appears in the input buffer of the remote 
station. 



Write Initial Conversational (TIV) 



Write TIV dials the remote station whose telephone number appears in the 
addressing list, exchanges identification sequences with it, sends a 
message block, and receives a response to text followed by a message 
block (if any). 



r 

1 

1- 

1 1- 


Operation 
Dial 


t 

| Address 

4 

1 List 


"T* 

! 


-1 

Flags 
.) 

CC, SLI 


r — 

TP-OP 


01 


Code 


— T 

1 

1 


Count 
List 


1 

H 


1 2. 


Write ID ENQ 


| List 




CC # SLI 


03 






List 




1 3- 


Read ID ACK-0 


I List 




SLI 


07 






List 




1 t- 


Write text 


J Area 




CC, SLI 


11 






Length 




1 5- 


Read response 


I Area 




CD, SLI 


25 






20 




| 6. 

L 


Read text 


| Area* 20 


-X- 


SLI 




11 






A- 


Length 
-20 


-j 



1. The telephone number of the remote station is dialed. 

2. The identification sequence of the central computer, followed by 
ENQ, is sent to the remote station* (The ID sequence is optional; 
the ENQ roust always be present.) 

3. The identification sequence (followed by ACK-0) is received from the 
remote station and is compared with the expected sequence contained 
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in the terminal list. If the two sequences do not match, the 
operation is posted complete-with-error. (The ID sequence is 
optional; the ACK-0 must always be present.) 

4. A message block is sent to the remote station- 

5. A response to text is read from the remote station. If the response 
is message text exceeding 20 characters* this command is 
data-chained to the next command. Otherwise, the operation is 
posted complete, with or without error. 

6. The remainder of the message block is read from the remote station. 



Virite Initial Conversational Transparent (TIVX) 



Write TIVX dials the remote station whose telephone number appears in 
the addressing list, exchanges identification sequences with it, sends a 
transparent message block and receives from the remote station a 
response to text followed by a message block (if any). 



T T T 

| Address | Flags | TP-OP Code 

— ^ + + 



I Operation 

1. Dial 

2. Write ID ENQ 

3. Read ID ACK-0 

4. Write text 

5. Write DLE ETX 

6. Read response 

7. Read text 



| List 


CC,SLI 


01 


| List 


CC„ SLI 


03 


| List 


SLI 


07 


| Area 


CC„ SLI 


11 


| Table 


CC, SLI 


13 


| Area 


CD W SLI 


25 


| Area+20 


SLI 


11 



X- 




1. The telephone number of the remote station is dialed. 

2. The identification sequence of the central computer, followed by 
ENQ, is sent to the remote station,. (The ID sequence is optional; 
the ENQ must always be present. ) 

3. The identification sequence (followed by ACK-0) is received from the 
remote station and is compared with the expected sequence contained 
in the terminal list. If the two sequences do not match, the 
operation is posted complete-with-error. (The ID sequence is 
optional; the ACK-0 must always be present.) 

4. A message block is sent to the remote station. 

(Note: The length specified should not include the ETX that might 
have been placed in the buffer during a previous operation.) 

5. The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the remote station. 

6. A response to text is read from the remote station. If the response 
is message text exceeding 20 characters, this command is 
data-chained to the next command* Otherwise, the operation is 
posted complete, with or without error. 
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7. The remainder of the message block is read from the remote station. 



Write Connect (TO 



Write TC is for use when calls to remote stations must be initiated 
manually by the console operator rather than by program control. 



Operation 



j Address j Flags 



TP-0P Code 



-T- 

I 



Count 



1. Enable 



j 2. Write ID ENQ 

I 

| 3* Read ID ACK-0 

l 





List 

List 



CC, SLI 
CC, SLI 
SLI 



01 
03 
07 



1 

List 

List 



1. The Enable command conditions the data adapter so that the console 
operator may manually dial a remote station. This command is 
terminated when the operator places the data set (modem) in data 
mode. 

2. The identification sequence of the central computer, followed by 
ENQ, is sent to the remote station. (The ID sequence is optional; 
the ENQ must always be present.) 

3. The identification sequence (followed by ACK-0) is received from the 
remote station and is compared with the expected sequence contained 
in the terminal list. If the two sequences do not match, the 
operation is posted complete-with-error. (The ID sequence is 
optional; the ACK-0 must always be present.) 



Write Continue (TT) 



Write TT is for use after initial transmission has occurred, to send 
another message block and receive a response from the remote station. 

r T T T T , 1 

| Operation | Address | Flags | TP-OP Code | Count | 

^ . + _ + + 1 < 

j 1, Write text | Area j CC,SLI j 11 | Length | 

1 III 1 1 

| 2*. Read response | Response] SLI | 25 12 | 



1. A message block is sent to the remote station* 

2. A response to text is read from the remote station; if it is not the 
expected response (ACK-0 or ACK-1), that fact is indicated in the 
DECB. 



Write Continue Transparent (TTX) 



Write TTX is for use after initial transmission has occurred, to send a 
transparent message block and receive a response from the remote 
station. 
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j Operation 



| 1, Write text 

I 

j 2. Write DLE ETX 

I 

| 3. Read response 



j Address j Flags j TP-OP Code | Count j 
H + + + ) 



Area 
Table 



j CC.SLI 

I 

j CCSLI 



Response | SLI 
.j i. 



11 
13 
25 



Length 

2 

2 



-L- 



X- 



J 



1. A message block is sent to the remote station. 



(Note: The length specified should not include the ETX that might 
have been placed in the buffer during a previous operation. ) 

2, The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the remote station, 

3, A response to text is read from the remote station; if it is not the 
expected response (ACK-0 or ACK-1), that fact is indicated in the 
DECB. 



Write Continue Transparent Block (TTE) 



Write TTE functions identically to Write Continue Transparent (TTX) 
except that the second command sends a DLE ETB sequence instead of a DLE 
ETX sequence; only the ETB appears in the input buffer of the remote 
station. 



Write Continue Conversational (TTV) 



Write TTV is for use aft'er initial transmission has occurred, to send 
another message block and receive from the remote station a response to 
text followed by a message block (if any). 



Operation 

1. Write text 

2. Read response 

3. Read text 



j Address j Flags 
1 + 

Area 



TP-OP Code 



Area 
Area+20 



CC W SLI 
CD, SLI 
SLI 



11 
25 
11 



I 



Count 

Length 

20 

Length 
-20 



1. A message block is sent to the remote station. 

2. A response to text is read from the remote station. If the response 
is message text exceeding 20 characters,, this command is 
data-chained to the next command. Otherwise, the operation is 
posted complete, with or without error. 

3. The remainder of the message block is read from the remote station. 
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Write Continue Conversational Transparent (TTVX) 



Write TTVX is for use after initial transmission has occurred, to send a 
transparent message block and receive from the remote station a response 
to text followed by a message block (if any) . 



j Operation 



"T T r T T 1 

I Address | Flags | TP-OP Code | Count } 



j. 1 + + + -J 



1. Write text 

2. Write DLE ETX 

3. Read response 

4 . Read text 
l J 



Length 

2 

20 

Length 
-20 

x x x J 



| Area 


CC, SLI 


11 


| Table 


CC* SLI 


13 


j Area 


CD„ SLI 


25 


| Area+20 


SLI 


11 



1. A message block is sent to the remote station. 

(Note: The length specified should not include the ETX that might 
have been placed in the buffer during a previous operation,) 

2. The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the remote station. 

3. A response to text is read from the remote station. If the response 
is message text exceeding 20 characters, this command is 
data-chained to the next command. Otherwise, the operation is 
posted complete, with or without error. 

4. The remainder of the message block is read from the remote station. 



Write Inquiry (TQ) 



Write TQ sends an ENQ and receives a response. This channel program is 
used (1) to solicit a response from a remote station when the previous 
response was invalid or an expected response was not received, or (2) to 
indicate to the remote station that the central computer wishes to 
transmit (used after the line connection has been established) . 



r 1 t t t 1 

I Operation | Address | Flags | TP-OP Code J Count ] 

| 1. Write ENQ | Table | CC,SLI | 03 J 1 



| 2* Read response 
I 3. Read text 



j Area j SLI, CD j 25 
. Area+20 SLI . 11 



20 



1 

I Length-20 



1. The ENQ character is either a request to the remote station to 
resend its last response or a bid for use of the line. 

2. A response to the ENQ is read from the remote station. The response 
is read into the user-supplied input area or the DECRESPN area if 
count is equal to or less than 2. If the response is message text 
exceeding 20 characters, this command is data-chained to the next 
command. Otherwise, the operation is posted complete, with or 
without error. 

3. The remainder of the message block is read from the remote station. 
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Write Reset (TR) 

Write TR is for use when the central computer has finished sending 
message blocks. 

r T T T T n 

| Operation | Address | Flags | TP-OP Code | Count \ 
h + + + + -, 

| 1. Write EOT j Table j CC„SLI j 08 I 1 1 

I III 11 
| 2. Read response | Response] SLI | OB I 2 ] 
l j j. x x J 



The EOT character informs the remote station that the central 
computer is relinquishing control of the line, 

A response to the EOT is read from the remote station. Valid 
responses are EOT (the remote station does not wish either to 
transmit or to break the line connection) ; ENQ (the remote station 
wishes to transmit) ; and DLE EOT (the remote station is breaking the 
line connection) . 



Write Wait-Before-Transmit (TW) 

Write TW is for use in place of a Read channel program that begins by 
sending a positive response to text (e.g. Read TT) . Write TW sends a 
WACK sequence, which the remote station treats as if it were the usual 
alternating acknowledgment (ACK-0 or ACK-1) ; the remote station responds 
to the WACK by sending an ENQ instead of another message block. This 
channel program may be reexecuted for as long as necessary for the 
central computer to delay receiving text. 

r T T T T 1 

| Operation | Address | Flags | TP-OP Code | Count ] 
h + + _ + + 1 

| 1. Write WACK | Table | CC,SLI | 01 ] 2 j 

I III i 1 

j 2. Read ENQ | Response] SLI | OB I 2 | 

L J. x x x J 

1. The WACK sequence informs the remote station that the central 
computer is temporarily not ready to continue receiving. 

2. An ENQ character is expected from the remote station. 



Write Break (TB) 

Write TB is used to break the line connection without first notifying 
the remote station. 

r T T T , T 1 

| Operation | Address ] Flags | TP-OP Code | Count ] 

| 1. Disable | | SLI | 21 J 1 1 

i x x x x J 



1* The Disable command breaks the line connection. 
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Write Disconnect (TD) 



Write TD is used to break the line connection after first notifying the 
remote station. 



j Operation 



Write DLE EOT 



| 2,. Disable 

l 



-T T T * T 1 

| Address | Flags | TP-OP Code | Count | 

| Table | CC,SLI | 21 | 2 | 

III I I 

| | SLI I 21 11 I 

_X X X X J 



1. The DLE EOT sequence informs the remote station that the central 
computer is going to break the line connection, 

2. The Disable command breaks the line connection. 
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NONSWITCHED MULTIPOINT LINE 



READ CHANNEL PROGRAMS 



Seven options are available for the READ macro instruction. The 
operation codes and corresponding options are: 

TI - Read Initial 

TT - Read Continue 

TTL - Read Continue with Leading Graphics 

TP - Read Repeat 

TPL - Read Repeat with Leading Graphics 

TQ - Read Inquiry 

TRV - Read Interrupt 

The channel programs for these options are as follows. 

Read Initial (TI) (Using Open Polling List) 

Read TI r when used with an open polling list, causes one pass to be made 
through the list, successively polling each of the remote stations 
represented by entries in the list. Upon receiving a positive response 
from any station in the list, a message block is received from that 
station. If all stations return negative responses, or if any station 
fails to respond at all, the channel program ends. 



"T T T T- 

| Address | Flags | TP-OP Code | Count 

1 



| Operation 

1. Write EOT (Poll) 

2. Poll 

3. I/O No-op 

4. Read index 

5. Read text 



| Table 


CQ, SLI 


02 


| List 


CC W SLI 


03 


1 o 


SLI 


09 


| Area 


CD 


0A 


| Area+2 


SLI 


11 




1. The EOT character places all remote stations on the line in control 
mode. 

2,. This command initiates the Auto Poll function* If a positive 

response is received for any remote station in the polling list, the 
channel program is restarted at command 4. If all stations return 
negative responses, or if any station fails to return a response, 
command (3) is executed. 

3. Execution of this command ends the channel program; the operation is 
posted complete. 

4. The index byte and the first character (if any) are read. 

5. The remainder of the message block is read from the remote station. 
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Read Initial (TI) (Using Wraparound Polling List) 



Read TI, when used with a wraparound polling list, causes continuous 
cycling through the polling list, successively polling each of the 
remote stations represented by entries in the list. Upon receiving a 
positive response from any station in the list, a message block is 
received from that station. If all stations return negative responses, 
polling is restarted from the beginning of the list. Polling is thus 
performed continuously until some station responds with a message block 
or the channel program is terminated, as by a RESETPL macro instruction. 

If any station fails to respond at all, timeout is indicated in 
DECSENSO and a completion code of X'Ul - is posted. 



"T T T T 

| Address | Flags \ TP-OP Code | Count 
H + + + . 



| Operation 
(. 

1. Write EOT 

2. Poll 

3. TIC 

4. TIC 

5. Poll 

6. TIC 

7. Read index 

8. Read text 



| Table 


CD* SLI 


08 


| List 


CC„ SLI 


03 




SLI 


09 




SLI 


09 


j List 


CC„ SLI 


03 




SLI 


09 


| Area 


CD 


0A 


| Area+2 


SLI 


11 




1. The EOT character places all remote stations on the line in control 
mode. 

2. This command initiates the Auto Poll function, starting with the 
remote station whose polling list entry is specified in the macro. 
If that station or any station whose list entry follows that 
station's entry returns a positive response, the status modifier bit 
is turned on in the CSW, which causes the next command to be 
skipped. If all stations return negative responses, or if any 
station fails to return a response* the next command is executed. 

3. The TIC command restarts the channel program at command 5. 

4. The TIC command restarts the channel program at command 7. 

5. This command restarts the Auto Poll function, starting with the 
remote station whose polling list entry appears first in the list. 
If that station or any other station appearing in the list returns a 
positive response, the status modifier bit is turned on in the CSW, 
which causes the next command to be skipped. If all stations return 
negative responses, the next command is executed. If any station 
fails to respond at all, timeout is indicated in DECSENS0 and a 
completion code of X'Ul 1 is posted, 

6. The TIC command restarts the channel program at command 5. 

7. The index byte and the first text character (if any) are read. 

8. The remainder of the message block is read from the remote station.. 
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Read Continue (TT) 



Read TT is for use following successful receipt of a message block from 
a remote station. It sends a positive response and receives another 
message block from the same station. 



-T T T T 1 

| Address | Flags | TP-0P Code | Count J 

| Table | CC,SLI | 08 I 2 ] 

III 11 
III II 
j Area | SLI | 11 j Length j 
-J j. x x J 



| Operation 

| 1. Write ACK-0 
| or ACK-1 

I 

| 2. Read text 

l 



1. A positive response to text (ACK-0 or ACK-1) is sent to the remote 
station, 

2. A message block is read from the remote station. 



Read Continue with Leading Graphics (TTL) 



Read TTL is an extension of the Read Continue channel program and is 
used similarly. It is for use where the positive response is to be 
preceded by user-specified graphic characters. 



r t t 

| Operation | Address | Flags 



-T T- 

I TP-OP Code j 
_ + + - 



Count 



| 1. Write graphics 


| Area 


| CD 




01 


| 2. Write ACK-0 or 
| ACK-1 


| Table 


| CC„SLI 




08 


j 3. Read text 

L 


| Area 
x . 


| SLI 
.-X 


-X 


11 




1. One to seven graphics are sent to the remote station. 

2. A positive response to text (ACK^-0 or ACK-1) is sent to the remote 
station. 

3. A message block is read from the remote station. 



Read Repeat (TP) 



Read TP is for use following unsuccessful receipt of a message block 
from a remote station. It sends a negative response and reads a message 
block from the same station. The station should react to the negative 
response by resending the same message block that elicited the negative 
response. 



| Operation | Address | Flags | TP-OP Code | Count 1 

| 1. Write NAK | Table | CC f SLI | 08 | 1 | 

I III II 
| 2. Read text j Area j SLI | 11 j Length | 
l j x x x J 
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1. A NAK character is sent to the remote station. 

2. The previous message block is reread from the remote station. 

Read Repeat with Leading Graphics (TPL) 

Read TPL is an extension of the Read Repeat channel program and is used 
similarly. It is for use where the negative response is to be preceded 
by user-specified graphic characters. 



T T T 1 

Address | Flags | TP-OP Code | Count | 

Length 

1 

Length 



| Operation 

| 1. Write graphics 

I 

j 2. Write NAK 

I 

| 3. Read text 

l 



| Area 


CD 


01 


| Table 


CC, SLI 


08 


j Area 


SLI 


11 



1. One to seven graphics are sent to the remote station. 

2. A NAK character is sent to the remote station. 

3. The previous message block is reread from the remote station* 

Read Inquiry (TQ) 

Read TQ receives an incoming character in the DECRESPN field. This 
channel program is for use when an ENQ is expected from the remote 
station. 



| Operation 
I- 

j 1. Read ENQ 

L 



. T T T T - 

| Address | Flags | TP-OP Code | 



Count 



| Response | SLI 
j x 



OB 



An ENQ character is expected from the remote station. 



Read Interrupt (TRV) 

Read TRV sends an RVI (Reverse Interrupt) sequence and receives text 
from the remote station. This channel program is for use where the 
preceding message block from the station was received without error, but 
the central computer wishes temporarily to stop receiving message text. 
The remote station may continue sending message text, or it may send 
EOT, signifying that it has finished sending. 

r T T T T 1 

| Operation | Address | Flags | TP-OP Code | Count | 

,. + + + 1 ., 

j 1. Write RVI sequence j Table | CC t SLI j 08 I 2 j 

I III II 

| 2. Read text j Area j SLI j 11 j Length j 

L J X X X J 
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1. A reverse interrupt (RVI) sequence is sent to the remote station, 
which treats it as though it were the correct alternating positive 
acknowledgment (ACK-0 or ACK-1). 

2. A message block or EOT is received from the remote station. 



WRITE CHANNEL PROGRAMS 



Seventeen options are available for the WRITE macro instruction. The 
operation codes and corresponding options are: 

Initial 

Initial and Reset 

Initial Transparent 

Initial Transparent and Reset 

Initial Transparent Block 

Initial Conversational 

Initial Conversational Transparent 

Cont inue 

Continue and Reset 

Continue Transparent 

Continue Transparent and Reset 

Continue Transparent Block 

Continue Conversational 

Continue Conversational Transparent 

Inquiry 

Reset 

Wait-bef ore-Transmit 

The channel programs for these options are as follows. 



TI 


- 


Write 


TIR 


- 


Write 


TIX 


- 


Write 


TIXR 


- 


Write 


TIE 


- 


Write 


TIV 


- 


Write 


TIVX 


- 


Write 


TT 


- 


Write 


TTR 


- 


Write 


TTX 


- 


Write 


TTXR 


- 


Write 


TTE 


- 


Write 


TTV 


- 


Write 


TTVX 


- 


Write 


TQ 


- 


Write 


TR 


- 


Write 


TW 


- 


Write 



Write Initial (TI) 

Write Initial and Reset (TIR) 

Write TI and TIR reset to control mode all remote stations on the line* 
address a specific remote station, read a response, and if the response 
is positive, send a message block and receive a response to text. Write 
TIR sends an EOT to reset the stations to control mode if a positive 
response to text is received. 



r T T T T 1 

| Operation | Address | Flags | TP-0P Code J Count | 



1 1- 


Write EOT 


| Table 


CC.SLI 


02 


1 2. 


Write addressing 
characters 


List 


CC„ SLI 


03 


1 3. 


Read response 


Response 


SLI 


06 


1 t. 


Write text 


Area 


CC, SLI 


11 


1 5. 


Read response 


Response 


SLI 


25 


1 &• 


Write EOT 
(TIR only) 


Table 


SLI 


21 




1. The EOT character places all remote stations on the line in control 
mode. 
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2. This command transmits the addressing sequence contained in the 
addressing list specified in the macro, 

3. The response to addressing is read from the addressed station. If 
the response is ACK-0, the channel program is restarted at the next 
command. Otherwise, it is posted complete. 

4. A message block is sent to the remote station. 

5. A response to text is read from the remote station; if it is not the 
expected response (ACK-0 or ACK-1)„ the condition is indicated in 
the DECB and the operation is posted complete (regardless of whether 
the Reset option was specified) . 

6. The EOT character places the remote stations on the line in control 
mode. 



Write Initial Transparent (TIX) 

Write Initial Transparent and Reset (TIXR) 

Write TIX and TIXR reset to control mode all remote stations on the 
line, address a specific remote station, read a response* and if the 
response is positive, send a transparent message block and receive a 
response to text. Write TIXR sends an EOT to reset the stations to 
control mode if a positive response to text is received. 



j Operation j Address j Flags j TP-OP Code j Count 

t ^ + + + . 



1. Write EOT 

2. Write addressing 

characters 

3. Read response 

4. Write text 

5. Write DLE ETX 

6. Read response 

7. Write EOT 
(TIXR only) 



| Table 


CC„ SLI 


02 


| List 


CC, SLI 


03 


| Response 


SLI 


06 


j Area 


CC, SLI 


11 


j Table 


CC, SLI 


13 


j Response 


SLI 


25 


j Table 


SLI 


21 




1. The ECT character places all remote stations on the line in control 
mode. 

2. This command transmits the addressing sequence contained in the 
addressing list specified in the macro. 

3. The response to addressing is read from the addressed station. If 
the response is ACK-0, the channel program is restarted at the next 
command. Otherwise, it is posted complete. 

4. A message block is sent to the remote station. 

(Note: The length specified should not include the ETX that might 
have been placed in the buffer during a previous operation.) 

5. The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the remote station. 
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A response to text is read from the remote station; if it is not the 
expected response (ACK-0 or ACK-D* the condition is indicated in 
the DECB and the operation is posted complete (regardless of whether 
the Reset option was specified) „ 

The ECT character places the remote stations on the line in control 

mode. 



Write Initial Transparent Block (TIE) 



Write TIE functions identically to Write Initial Transparent (TIX) 
except that the fifth command sends a DLE ETB sequence instead of a DLE 
ETX sequence; only the ETB appears in the input buffer of the remote 
station. 



Write Initial Conversational (TIV) 



Write TIV resets to control mode all remote stations on the line, 
addresses a specific remote station, reads a response, and if the 
response is positive, sends a message block and receives a response to 
text, followed by a message block (if any). 



Operation 



j Address j Flags j TP-OP Code 



-T- 
I 



Count 



1. Write EOT 

2. Write addressing 

characters 

3. Read response 

4. Write Text 

5. Read Response 

6. Read Text 



Table 
List 

Response 
Area 
Area 
Area+20 



CC # SLI 
CC* SLI 

SLI 

CC„ SLI 
CD„ SLI 
SLI 



02 
03 

06 
11 
25 
11 



1 
List 

2 

Length 

20 

Length 
-20 



The EOT character places all remote station on the line in control 
mode. 

This command transmits the addressing sequence contained in the 
addressing list specified in the macro. 

The response to addressing is read from the addressed station. If 
the response is ACK-0, the channel program is restarted at the next 
command. Otherwise, it is posted complete. 

A message block is sent to the remote station. 

A response to text is read from the remote station. If the response 
is message text exceeding 20 characters* this command is 
data-chained to the next command. Otherwise, the operation is 
posted complete, with or without error. 

The remainder of the message block is read from the remote station. 
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Write Initial Conversational Transparent (TIVX) 



Write TIVX resets to control mode all remote stations on the line, 
addresses a specific remote station, reads a response, and if the 
response is positive, sends a transparent message block and receives a 
response to text, followed by a message block (if any). 



r 

1 

1~ 


1. 


Operation 
Write EOT 


— T 

| Address 
-H 

| Table 


-T- 

1 

4- 


Flags 
CC # SLI 


1 
-+- 


TP-OP 
02 


Code 


— T _ 

1 


Count 
1 


1 

H 




2. 


Write addressing 
characters 


| List 




CC# SLI 




03 






List 






3. 


Read response 


| Responsej 


SLI 




06 






2 






I*. 


Write Text 


| Area 




CC„ SLI 




11 






Length 






5. 


Write DLE ETX 


I Table 




CC„ SLI 




13 






2 






6. 


Read Response 


| Area 




CD, SLI 




25 






20 




L. 


7. 


Read Text 


| Area+20 
— j 


-X. 


SLI 


-X- 


11 




X_ 


Length 
-20 


_j 



1. The EOT character places all remote stations on the line in control 
mode. 

2. This command transmits the addressing sequence contained in the 
addressing list specified in the macro. 

3. The response to addressing is read from the addressed station. If 
the response is ACK-0, the channel program is restarted at the next 
command. Otherwise, it is posted complete. 

4. A message block is sent to the remote station. 

5. The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the station. 

6. A response to text is read from the remote station. If the response 
is message text exceeding 20 characters* this command is 
data-chained to the next command. Otherwise, the operation is 
posted complete, with or without error. 

7. The remainder of the message block is read from the remote station. 



Write Continue (TT) 

Write Continue and Reset (TTR) 

Write TT and TTR are for use after initial transmission has occurred, to 
send another message block and receive a response from the remote 
station. Write TTR sends an EOT to reset the stations to control mode 
if a positive response to text is received. 
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- T T - 

Address j Flags | TP-0P Code 

-+ +- 

CC«, SLI 



| Operation 



1. Write text 



j 2. Read response 

I 

j 3. Write EOT 

| (TTR only) 

l 




1, A message block is sent to the remote station, 

2, A response to text is read from the remote station; if it is not the 
expected response (ACK-0 or ACK-1), the condition is indicated in 
the DECB and the operation is posted complete (regardless of whether 
the Reset option was specified) . 

3, The EOT character places the remote stations on the line in control 
mode. 

Write Continue Transparent (TTX) 

Write Continue Transparent and Reset (TTXR) 

Write TTX and TTXR are for use after intitial transmission has occurred^ 
to send a transparent message block and receive a response to text from 
the remote station. Write TTXR sends an EOT to reset all stations to 
control mode, if a positive response to text is received. 



T T T 1 

Address | Flags | TP-0P Code | Count 



| Operation 



(, + + + + \ 



1. Write text 

2. Write DLE ETX 

3. Read response 

4. Write EOT 
(TTXR only) 



| Area 


CC* SLI 


11 


| Table 


CC„ SLI 


13 


| Response 


SLI 


25 


| Table 


SLI 


21 



Length 

2 

2 

1 



L J ± -L J. J 



3. 



4. 



A message block is sent to the remote station. 

(Note: The length specified should not include the ETX that might 
have been placed in the buffer during a previous operation.) 

The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the remote station. 

A response to text is read from the remote station; if it is not the 
expected response (£CK-0 or ACK-1), the condition is indicated in 
the DECB and the operation is posted complete (regardless of whether 
the Reset option was specified) . 

The EOT character places the remote stations on the line in control 
mode. 



Write Continue Transparent Block (TTE) 



Write TTE functions identically to Write Continue Transparent (TTX) 
except that the second command sends a DLE ETB sequence instead of a DLE 
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ETX sequence; only the ETB appears in the input buffer of the remote 
station. 



Write Continue Conversational (TTV) 



Write TTV is for use after intial transmission has occurred, to send 
another message block and receive from the remote station a response to 
text followed by a message block (if any) . 



r — ~ - 

| Operation 

1 1. Write text 


T ~ - T - - "- 

| Address | Flags 
| Area | CC W SLI 


1 


TP-OP 


Code 


— T - 

1 
— +- 


1 

Count ) 

Length | 


11 




| 2. Read response 


| Area ) CD, SLI 




25 






20 1 


1 3. Read text 

L 


| Area+20 | SLI 
J. J. 


_±- 


11 




— X- 


Length j 
-20 | 

j 



1. A message block is sent to the remote station, 

2. A response to text is read from the remote station. If the response 
is message text exceeding 20 characters, this command is 
data-chained to the next command. Otherwise, the operation is 
posted complete, with or withbut error. 

3. The remainder of the message block is read from the remote station. 



Write Continue Conversational Transparent (TTVX) 

Write TTVX if for use after initial transmission has occurred, to send a 
transparent message block and receive from the remote station a response 
to text followed by a message block (if any> . 



Operation 

1. Write text 

2. Write DLE ETX 

3. Read response 

4. Read text 

L 



"1 T T T t 

| Address | Flags | TP-OP Code | Count | 



Area 
Table 
Area 
Area+20 



CC W SLI 
CC„ SLI 
CD, SLI 
SLI 



11 
13 
25 
11 



Length 
-20 



Length 

2 

20 



1. A message block is sent to the remote station. 

(Note: The length specified should not include the ETX that might 
have been placed in the buffer during a previous operation.) 

2. The two-character sequence DLE ETX is sent to the remote station; 
only the ETX appears in the input buffer of the remote station. 

3. A response to text is read from the remote station. If the response 
is message text exceeding 20 characters* this command is 
data-chained to the next command. Otherwise, the operation is 
posted complete, with or without error. 
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The remainder of the message block is read from the remote station. 



Write Inquiry (TQ) 

Write TQ sends an ENQ and receives a response. This channel program is 
used to solicit a response from a remote station when the previous 
response was invalid or an expected response was not received. 

r T T T T n 

j Operation | Address | Flags | TP-OP Code ] Count | 
|. + + + + i 

I 1. Write ENQ | Table | CC„ SLI | 03 | 1 

I I I I I 

| 2. Read response | Area | SLI,CD | 25 | 20 

I I I I » 

3. Read text I Area+20 i SLI I 11 ■ Length-20 



1. The ENQ character requests the remote station to resend its last 
response. 

2. A response to the ENQ is read from the remote station. The response 
is read into the user-supplied input area or the DECRESPN area if 
count is equal to or less than 2. If the response is message text 
exceeding 20 characters, this command is data-chained to the next 
command. Otherwise , the operation is posted complete , with or 
without error. 

3. The remainder of the message block is read from the remote station. 



Write Reset (TR) 

Write TR is for use when the central computer wishes to reset to control 
mode all remote stations on the line. 

r T T T T T 

| Operation | Address | Flags | TP-OP Code | Count | 

| 1. Write EOT | Table | SLI I 21 | 1 | 

L J JL X -L J 



1. The EOT character places the remote stations on the line in control 
mode. 

Write Wait-Before-Transirit (TW) 



Write TW is for use in place of a Read channel program that begins by 
sending a positive response to text (e.g. Read TT) • Write TW sends a 
WACK sequence, which the remote station treats as if it were the usual 
alternating acknowledgment (ACK-0 or ACK-1) ; the remote station responds 
to the WACK by sending an ENQ instead of another message block. This 
channel program may be reexecuted for as long as necessary for the 
central computer to delay receiving text. 
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r T T ^ T T 1 

I Operation | Address | Flags | TP-OP Code ] Count | 

i. — : ^ + + + ^ 

| 1, Write WACK J Table | CC f SLI j 01 I 2 | 

I III II 

| 2. Read ENQ | Response! SLI j OB I 2 j 

L J. J. ± A ; J 



1, The WACK sequence informs the remote station that the central 
computer is temporarily not ready to continue receiving. 

2. An ENQ character is expected from the remote station. 
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IOCAL CHANNEL PBOGBAMS 



IOCAL IBM 3270 DISPLAY SYSTEM 



BEAD CHANNEL PBOGBAMS 

Five options are available for the BEAD macro instruction. 
The operation codes and corresponding options are: 

TI - Bead Initial 

TM - Bead Modified 

TMP - Bead Modified from Position 

TB - Bead Buffer 

TBP - Bead Buffer from Position 

The channel programs for these options follow. 



Bead TI reads modified fields from a local 3270 display station after 
the display station operator causes an attention interruption. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Select 

2. Read Modified 


area 
area 


CC 
SLI 


00 
00 


length 
length 



lead KodifieJL(Ttt), 

Bead TM reads modified fields from a local 3270 device independently of 
action by the display station operator. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Select 

2. Read Modified 


area 
area 


CC 
SLI 


00 
00 


length 
length 



Bead Modified from Eositio_n„iTMPI 

Bead TMP reads- modified fields from a local 3270 device beginning at a 
specified location in the buffer. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Select 

2. Write 

3. Read Modified 


area 
area 
area 


CC 

CC, SLI 
SLI 


00 
00 
00 


length 

4 
length 
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B €ad Buffer (TE) 

Bead TB reads the entire buffer of a local 3270 device. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Select 

2. Read buffer 


area 
area 


CC 
SLI 


00 
00 


length 
length 



Read Buffer from Position (TBP) 

Read TBP reads the entire buffer of a local 3270 device beginning at 
a specified location. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Select 

2. Write 

3. Read buffer 


area 

area 
area 


CC 

CC, SLI 
SLI 


00 

00 
00 


length 

4 
length 



WRITE CHANNEL PROGRAMS 

Three options are available for the WRITE macro instruction, 
operation codes and corresponding options are: 

TI - Write Initial 

TS - Write Erase 

TUS - Write Unconditional Erase 

The channel programs for these options follow. 



The 



Write initial^JTIL 

Write TI writes a message to a local 3270 device. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Select 

2. Write 


area 
area 


CC 
SLI 


00 
00 


length 
length 



Write Erase (TS) 

Write TS clears the buffer cf a local 3270 device to nulls (binary 
zeros) and writes a message to the device. 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1 . Erase/Write 


area 


SLI 


00 


length 
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Write Unprotected Erase (TOS ) 

Write TOS clears all unprotected fields in the buffer of a local 3270 
device to nulls (binary zeros) • 



Operation 


Address 


Flags 


TP-Op Code 


Count 


1. Erase all unprotected 

2. NOP 


area 


CC, SLI 


00 


1 
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CHARTS 



Chart 01. BTAM Open Executor (IGG0193M) (Load 1) (Part 1 of 2) 
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Chart 01A. BTAM Open Executor (IGG0193M) (Load 1) (Part 2 of 2) 



r-B4- 



BUILD BYTE WITH 
ADAPTER/MODEL 
TYPE & BUILD BYTE 
WITH SPECIAL 
FEATURE FLAGS 



ERROR 
,C3- 



SET ABEND 
CODE: = 94 FOR 
INVALID ADAPTER 
/MODEL = 93 FOR 
INVALID SPECIAL 
FEATURE 



J? 



C4 COMPARE 
ADAPTER/MODEL LOW 



SCAN1 
r C5- 



TYPEWITH 

^YPETAB 

TNTRY' 



Tequal 



( ABEND J 



/•D4- 
/SET SWITCH 
/ TO INDICATEN 
( VALID 
\ ADAPTER/ 

Xmodeltype/ 



GET NEXT 
TYPETAB AND 
SPFETAB 
ENTRY 
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Chart 01 B. BTAM Open Executor (IGG0194N) (Load 2) 




GETPOOL 
-G4 



SAVE MODULE 
NUMBER AND 
IDTTRL FOR LOAD 
3 OF OPEN 
EXECUTOR 



GET NO. OF 
BUFFERS AND 
LENGTH 



COMPUTE SIZE 
OF BUFFER 
AREA 



GET MAIN 
STORAGE FOR 
BUFFER POOL 



BUILD BUFFER 
CHAIN 
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Chart 02, BTAM Open Executor (IGG0193Q) (Load 3) (Part 1 of 2) 



SETSIZE 
-A3. 




(^ 



STORE IOB SIZE 
IN DCB & 
MULTIPLY SIZE 
BY NO. OF LINES 
TO GET TOTAL 



SVC 10 



GET MAIN 
STORAGE FOR 
lOB'S FROM 
SUBPOOL 250 



SAVE IRB ENTRY 
POINT AND GET 
BSC SPECIAL 
CHARS 



TSTRETRY 
r-El 



•C3- 
STORE STORAGE 
ADDRESS MINUS 
IOB SIZE IN 
DCB 



VALIDATE 
READ RETRY 
•SPECIFICATION 
IN DCBEROPT 




USE DEVICE 
TYPE CODE TO 
OBTAIN IOB 
SIZE 




IRBPNT 
nG2— 



-HI 1 

ADD 24 TO 
IOB SIZE FOR 
DYNAMIC BUF- 
FERING CCW'S 



YES y 1130/2250 
^ GRAPHICS 



SVC 10 



GET MAIN 
STORAGE 
FOR IRB 
POINTERS 



NOPNTRS 
n H2 ' 

POINT TO 
TABLE OF UCB 
ADDRESSES 



^_ 
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Chart 03, BTAM Open Executor (IGG0193Q) (Load 3) (Part 2 of 2) 




GET MAIN 
STORAGE 



RETRY 
rr F4- 



«-© 



RETRY 

CHANNEL 

PROGRAM 



GET IOB 
ADDRESS 



STIMER 
H4- 



WAIT FOR 

ERPTO 

COMPLETE 




-E5 

TURN OFF 
COMPLETION 
FLAG IN 
ECB 



NOTIFY OPER 
THAT TCU IS 
NOT OPER'L 



WAIT FOR 
REPLY 



(INVALID) 
H5 




SET ERROR FLAG 
IN IOB 




NORMA Li 
K5- 



fc 



FREE MAIN 
STORAGE FOR 
POINTERS 
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Chart 04 • BTAM Open Executor (IGG0193S) (Load 4) (Part 1 of 2) 



C IGG0193S J 




INITIALIZE 
REGISTERS 



GRAPH 1 

r-E4 — 



INITIQE 05G1 



INITIALIZE IQE 



SAVE IRB 
ADDRESS 




PROTECT 
DCBOFLGS 
FIELD FOR 
SAVING READ/ 
WRITE ADDRESS 




( ABEND 



RWVD1 
-G5- 



SAVE DEVICE 
COUNT, 
VECTOR LIST 
ADDRESS 



ENDLOD4 
H5 — 



CLEAR ID TO 

INDICATE 

COMPLETION 



RELOOP 
_J5 



STEP POINTER 
TO WTG AND 
PARAMETER 
LIST ENTRIES 



MAKE 

COUNT V— I 

NONZERO / 
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Chart 05. BTAM Open Executor (IGG019 3S) (Load 4) (Part 2 of 2) 




INITIALIZE 
CURRENT WTG 
TABLE & 

PARAMETER LIST 
POINTERS 




C 







GET ADDRESS 
OF IQE 
POINTER 



r -H2_ 



STEP TO NEXT 
IQE AND 
DECREMENT 
NUMBER OF 
EXTENTS 



BEGIN PUTTING 
IQE'S IN 
NEXT WORD & 
GET TCB ADDR 



®~ 



04H4, 04E1 
04G1, 04G3, 04 J2 




C 



3 



-B5- 

GET NUMBER 
OF EXTENTS & 
COMPUTE WORK 
AREA SIZE 



INITIQE 05G1 



INITIALIZE IQE 



C 



3 



ADD 1000 

TOTTR 

LENGTH 


/INDICATE \ 
/ LENGTH N 
< OF FIRST 
\ TEXTRECORDy 



©- 

kD N — / 



-G4- 



GET 

COMMUNICATION 
VECTOR TABLE 
ADDRESS 



SAVE^ADDRESS 
OF NEXT IQE 



~& 




LOAD 

ROUTINE 

SPECIFIED 



rJ4- 
/iNCREMENT ' 







J 



04F1, 04G3 
04H2, 04H3 
04J3 
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Chart 05A. BTAM Open Executor and Local 3270 BTAM Open 

Executor (Common to all Loads) WTG Table Routine 



THIS CODE OCCURS IN ALL BTAM OPEN EXECUTOR MODULES 
(IGG0193M, IGG0I94N, IGG0193Q, IGG0193S, AND IGC0194P): 



EXIT 
B3- 



SET UP NEW ID 
IN CURRENT 
ENTRY OF 
WTG TABLE 



LAST MODULES (IGG0193S AND IGG0194Q) 
SET NEW ID TO ZERO; OTHER MODULES SET 
ID OF NEXT MODULE: 

IGG0I93M SETS 4P (FOR DEVICE CLASS = GRAPHICS) 

IGG0193M SETS 4N (FOR DEVICE CLASS = COMMUNICATION 
EQUIPMENT) 

IGG0194NSETS3Q 

IGG0193Q SETS 3S 

IGG0194P SETS 4Q 



STEP POINTERS 
TO WTG AND 
PARAMETER 
LIST ENTRIES 




INITIALIZE WTG 
TABLE & PARAM 
LIST POINTERS 
TO FIRST 
ENTRIES 




NOTE: WTG - WHERE-TO-GO TABLE 
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Chart 05B. Local 3270 BTAM Open Executor (IGG0194P) (Part 1 of 3) 



f ENTRY FROM A 
( IGG0193M VIA I 
V XCTL J 



ESTABLISH 

DDRESSABILITY 

FOR DCB AND 

DEB DSECTS 




STORE I OB POOL 

BASE ADDRESS IN 

DCB 



/set i 
^valu: 



UCB INDEX" 
VALUE TO ZERO 



CLEAR CORE FOR 
ONE I OB 



INITLP 

/— A4- 



-B3- 



INITIALIZE 

IOBFLAG1, 

IOBSTART. 

IOBDCBPT, AND 

IOBUCBX 




GET IRB POINTER 

AREA AND STORE 

ADDRESS IN 

DEBIRBAD 



/GET NUMBER 
/OF DVCS, ADDR\ 
<OF DEB UCB LIST> 

"ND IOB POOL 



/ GE r 

V 



GET ADDRESS 
OF UCB 



SAVE OLTEP 

EXECUTING FLAG 

FROM GCB 



CLEAR ATTENTION 

HANDLING FIELDS 

IN UCB 

EXTENSION 




INCREMENT UCB 

INDEX BY 1 TO 

OBTAIN RLN AND 

STORE IN UCB 




CREATE ERASE 

WRITE CHANNEL 

PROGRAM IN IOB 

CPA 



GETMAIN FOR 

WTOR AREA AND 

ECB 



STORE ADDRESS 
OF ECB IN IOB 
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Chart 05C. Local 3270 BTAM Open Executor (IGG0194P) (Part 2 of 3) 



r 
© 



ISSUE EXCP TO 
DO WRITE 



CLEAR TIMER 
LOOP COUNTER 



0- 



STIMER WAIT 
FOR 1/2 
SECOND 



BUILD PURGE 

PARM LIST IN 

WTOR AREA 



PURGE I/O 

OPERATION 

REQUEST 




WAIT FOR 

OPERATION TO 

COMPLETE 




I NCR TIMER 
<LOOP COUNTER BY' 



L 



© 
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Chart C5D. Local 3270 BTAM Open Executor (IGG0194P) (Part 3 of 3) 




ISSUE WTOR 



cr ' 


' 




RELEASE 
MESSAGE 






/ CLEAR 

<COMPLETION CODE] 
\ IN ECB 



BYPASSIO 



SET OLTEP 

EXECUTING FLAG 

IN IOB 



FLAG 
INITIALIZATION 
FAILURE IN IOB 



U 
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Chart 05E* Local 3270 BTAH Open Executor (IGG0194Q} (Part 1 of 2) 



IGG0194Q 



f ENTRY FROM A 
f IGG0194P VIA 1 
V XCTL J 





ROUND BUFFER 
LENGTH TO NEXT 

FULL WORD AND 

STORE LENGTH IN 

DCB 



COMPUTE TOTAL 

SIZE OF BUFFERS 

PLUS BUFFER 

CONTROL BLOCK 



STORE ADDRESS 

OF BUFFER 

CONTROL BLOCK 

IN DCB 



INITIALIZE THE 

BUFFER CONTROL 

BLOCK AND LINK 

BUFFERS 

TOGETHER 



OBTAIN 

■DDRESS OF DEB 

SUBID FIELD 




LOAD LOCAL 3270 
OLT CONTROL RTN 



BUILD IRB AND 
IQE'S FOR OLT 



STORE IRB 

ADDRESS IN IRB 

POINTER AREA 




LOAD BUFFER 

MANAGEMENT 

ROUTINE 



«H2° 



STORE ADDRESS 

OF BUFFER 

MANAGEMENT 

ROUTINE IN DEB 



LOAD LOCAL 3270 
CEA/XEA RTN 



STORE ADDRESS 

OF CEA/XEA IN 

DEB CEA AND XEA 

VECTORS 



LOAD BTAM 

READ/WRITE 

ROUTINE 



STORE ADDRESS 

OF READ/WRITE 

ROUTINE IN DCB 





0VRFLO 

f ABEND WITH A 
► 1 SYSTEM 097 CODEj 



LOAD LOCAL 3270 
DDM 




XINCR INDICES 
CFOR NEXT ENTRY 



L 



© 



STORE ADDRESS 
AND DEVICE CODE 
IN VECTOR TABLE 



L 
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Chart 05F. Local 3270 BTAM Open Executor (IGG0194Q) (Part 2 of 2) 



( ENTRY J 



f ENTRY J 



BUILD IRB 6 1 

IQE FOR ATTN 

HANDLING 



-B2- 



CONSTRUCT BLDL 

LIST ENTRY IN 

OPEN WORK AREA 

FROM IDTTRL 

ENTRY 



STORE IRB 

ADDRESS IN ALL 

UCB'S OF LINE 

GROUP 



CLEAR 

WHERE-TO-GO ID 

TO INDICATE END 

OF OPEN 



i 




ADD X'800' TO 

RTN LENGTH 

DERIVED FROM 

IDTTRL 



w 




INVOKE CIRB 
TO BUILD IRB 





IQEINIT 



LENGTH OF FIRST 

TEXT RECORD = 

1024 BYTES 



INITIALIZE 
IQE'S AND LINK 
THEM TOGETHER 



) TO STANDARD 

WHERE-TO-GO 

CODE 



D 



LENGTH OF FIRST 

TEXT RCD = SIZE 

OF ROUTINE 



MODIFY LOAD 

ATTRIBUTES FOR 

MULTIPLE TEXT 

RECORDS 



SET LINK OF 
LAST IQE = ZERO 



LOAD RTN FROM 
SYS1 .SVCLIB 



G 



j 



STORE ID IN 
CURRENT DEB 
SUBID ENTRY 



y— H_ 
/ INCREMENT , 
/ POINTER TO 
<NEXT DEB SUBID 
\ ENTRY 



r~* 2 

V RE 



J 
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Chart 06. Buffer (IGG019MS) 



c 



A2 

IGG019MS 



) 




YES 



REQUEST 





NOTENUF 
-D2 



RESTORE BCB 
COUNT OF 
AVAILABLE 
BUFFERS 



i — El - 

UPDATE BCB WITH 
NEW COUNT OF 
AVAILABLE BFRS 
AND ADDRESS OF 
FIRST ONE 



NOQUEUE 
-D3 — 



GET ADDRESS 
OF FIRST 
AVAILABLE 
BUFFER 





NOBCB 
r-C5 - 



SET 'INVALID 
BCB ADDRESS' 
FLAG (X'l2') IN 
REGISTER 



NO YES 



i-Fl- 
PLACE ADDRESS 
OF FIRST AVAIL- 
ABLE BUFFER 
IN RETURN REG 



r-F2- 
PLACE ADDR OF 
FIRST BFR AND 
COUNT OF UN- 
AVAILABLE BFRS 
IN PARAMREGS 



-Gl- 
ZERO THE 
CHAIN ADDRESS 
IN FIRST BUFFER 
OBTAINED 



-G2- 
ZERO THE BCB BFR 
ADR & COUNT; 
PLACE 'SOME BFRS 
AVAIL' CODE 
(X'04') IN REG 




YES 



r- E4 - 

REMOVE THAT 
CCW FROM 
QUEUE; GIVE IT 
BUFFER ADDR 
AND LENGTH 



r— F3 ■ 

RETURN 
BUFFERS; UP- 
DATE BCB 



/ MODIFY 
/CHANNEL PGMK 
\ SET READ, READ/ 
\ SKIP, AND 

\ TIC CMNDS/ 



EXITA 
I— H3 - 



PLACE (X'08') IN 
REG (IF REQ, = 
'NO BFR AVAIL'; 
IF REL, = 'AL- 
READY RETURNED') 



EXIT 

C 




RETURN 



j 
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Chart 07. Line Open (IECTIOPN) 




SETADD 
-B4 — 



SETUP 

SET ADDRESS 

COMMAND 



SET RETURN 
CODEX 1 14' 
IN REG 15 




SETUP 
SET MODE 
COMMAND 



f RETURN J 




-E5 

TURN OFF 
COMMAND 
CHAIN FLAG 
IN LAST CCW 



0- 



SET UP ENABLE 
COMMAND 



EXCP1 
F5- 



SVCO 



EXECUTE 
LINE OPEN 
CHANNEL 
PROGRAM 



STIMER 

n G5_ 



YES 



(=R 




K4 DID 
CHAN PGj 
COMPLETE 
^— S \ NORMALLY' 
S (X7F' 
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Chart 08, Translate (IECTTRNS) 




C2' 

' DYNAMIC ^V YES 
BUFFERING > 



^ REMAINDER v YES 
NEG OR 




TRANSLATE 
256 BYTES 



UPDATE 
ADDRESS 




-►< COUNT 
GIVEN 
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Chart 09. REQBUF/RELBUF (IGC058) 




1U0 



Chart 10. BTAB Close Executor (IGG0203M) 






& 




DISABLE 
ALL LINES 



FREEIOBS 
"fC2 



SVC 10 



FREE MAIN 
STORAGE 
FOR lOB'S 



DCB INIT 
-F2 — 



REINITIALIZE 
DCB FIELDS 



rG2- 

INDICATE COM- 
PLETION OF 
BTAM CLOSE 
EXECUTOR FOR 
THIS REQUEST 




FREE MAIN 
STORAGE 
FOR IRB'S 



©Z<! 




E3- 



SVC10 



FREE MAIN 
STORAGE 
FOR BUFFER 
POOLS 



-G3- 



PLACE IDTTR FOR 
STRAM INTO WTG 
TABLE 



c 



-C4- 



3 



FREE MAIN 
STORAGE FOR 
IRB'S 



C 



J 




SVC 16 



PURGE I/O 
REQUESTS 
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Chart A1. BTAM Read/Write (IGG019MA) (Part 1 of 4) 



NOTE: 

AN INDEX VALUE IN BYTES 1 AND 6 OF THE CCW 
DETERMINES WHICH OF SEVERAL SUBROUTINES 
IS USED TO COMPUTE THE AREA ADDRESS AND 
COUNT TO BE INSERTED INTO THE CCW. THESE 
SUBROUTINES ARE LISTED UNDER READ/WRITE 
ROUTINE (IGG019MA) IN THE BTAM ROUTINES AND 
ASSOCIATED MODULES CHAPTER OF THIS 
PUBLICATION. THE SUBROUTINES APPEAR IN 
CHARTS A2, A3, ANDA4. 
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Chart A2. BTAM Read/Write (IGG019MA) (Part 2 of 4) 



DATAREA 
-Al 



GET AREA 
ADDRESS FROM 
DECB 



BSCWAREA 
r-A2- 




PLACE ADDRESS 
IN CCW 




GF 



V 



BSCWLNG 
-HI — 



GET WRITE 
AREA ADDRESS 
FROM DECB 



RESPAREA 
-A3 



PLACE ADDRESS 
OF RESPONSE 
FIELD IN CCW 



BSCGRAPH 
r A4 



PLACE ADDRESS 
OF LEADING 
GRAPHICS IN 
CCW 



DBDATA 
-B2 — 



SETUP 
DYNAMIC 
BUFFERING 
CCW'S 



TESTLAST 



LIST 
C3-. 

PLACE ADDRESS 
& COUNT 
OF LIST IN 
CCW 



PA1050D 
-A5 



BYPASS DIAL 
DIGITS 



PA LIST 
-B5 - 



FIND FIRST 

NONSKIPPED 

ENTRY 



C5 . 

PLACE ENTRY 
ADDRESS IN 
CCW 



FRAME CH 
-E2 



UPDATE 

DECPOLPT 

FIELD 



COMPUTE 
OFFSET OF 
FRAME CHANGE 
SEQUENCE 



SPECCHAR 
CNTCHARS 
-F2 



PLACE ADDRESS 
OF SPECIAL 
CHARS OR FRAME 
CHANGE CHARS 
IN CCW 



TWXIDENT 
-F3 — 



PLACE ADDRESS 
AND COUNT OF 
ID SEQUENCE 
IN CCW 



DATALNG 
r F4 — 



PLACE LENGTH 
FROM DECB 
INTO CCW 



PLACE 

WLENGTH IN 
CCW 



BSCCHARS 
r H2 — 



COMPUTE OFF- 
SET OF 

CHARACTERS & 
PUT IN CCW 



BSCRESP 
-H3- 



DETERMINE 
PROPER RE- 
SPONSE &PUT 
ITS ADDRESS IN 
CCW 



H4- 
PLACE ADDRESS 
AND COUNT 
OF ID 

SEQUENCE IN 
CCW 



TESTLAST 
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Chart A3. BTAM Read/Write (IGG019MA) (Part 3 of 4) 



SCAN FOR SCAN 
STOP BYTE 




/ INCREMENT 
( USAGE 
\ COUNT 



FAEAD 
,-A3_ 



SAVE ENTRY 
ADDRESS 



SET RETURN 
CODEX'24' 
IN REG 15 



SET UP TIC 
COMMAND 




PLACE ADDRESS 
FROM DECENTRY 
INTO CCW 





SET UP SECOND 
TIC COMMAND 



MOVE IN THE 
POLL AND 
SECOND TIC 
COMMANDS 



API SCAN . 
r.F3- t 



SCAN FOR START 
ENTRY (ENTRY 
INDEX GREATER 
THAN OR EQUAL 
TO INDEX) 



AP3CONT 
r G3 



SET STARTING 
ADDRESS INTO 
FIRST POLL 
COMMAND 



,_H3_ 
FIND LENGTH OF 
POLLING LIST- 
USE AS COUNT 
FOR 2ND POLL 
COMMAND 



-J3_ 



FIND LENGTH 
FOR FIRST POLL 



r-K3- 
POINT REGISTER 
TO NEXT 
AVAILABLE CCW 
LOCATION 
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Chart A4. BTAM Read/Write (IGG019MA) (Part 4 of 4) 
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Chart B1. Channel End Appendage (IGG019MB) (Part 1 of 6) 



c 



j 



FIND CCW 




DrDID 
'SAD OR EN- 
ABLE ERROR 
SpCCUR/ 



SUBTRACT 8 
FROM CCW 
ADDRESS 





_NO/ SOH % R 

v PROCESSED , 




SIOCC1 
r G2- 



SIOCC 



/ H1 S|OCC 
<== 3 (SIO NOT 
OPERATIONAL) 



SIOCC10 



SET 'CTL UNIT 
OR LINEADDR 
NOT OPER- 
ATIONAL' BIT (0) 
IN DECERRST 



CSWADR 
P-H2 




POST2ER 

-G4— 



UPDATE 
DECPOLPT 



SET COMMAND 
ADDRESS IN 
CSW TO START 
ADDR +8 




TURN ON 
NEGATIVE 
RESPONSE BIT 
(5) OF 
DECFLAGS 



TPXX 



TPOA 
TPOAAB 
^J3- 



r 

/SA 



J4 _ 



SAVE INDEX N 
/ BYTE IN 
\ DECPOLPT 






UPDATE 
DECENTRY 
WITH CONTENT 
OF DECPOLPT 



TURN OFF I OB 

EXCEPTION 

FLAG 







TPOBAB 
r K2- 



BRANCH TO 
APPROPRIATE 
TP-OP CODE 
ROUTINE 



/TURN OFF 
/ HIOFLAG 
\ INUCB 



TPXX 
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Chart E2. Channel End Appendage (IGG019MB) (Part 2 of 6) 
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Chart E3. Channel End Appendage (IGG019MB) (Part 3 of 6) 




c — ^ 

f RETURN J 



148 



Chart B4. Channel End Appendage (IGG019MB) (Part 4 of 6) 




FIND FIRST 
READ OR WRITE 
TEXT CCW 





POST 
BUFFER 



WAS \ NO 

COMPLETION^ 
NORMAL. 





D3 DID 

yes/autopoll " 
\end prior to' 
read index 





/UP 



UPDAT1 
rG3— 



FIND INDEX 
BYTE IN LAST 
ACTIVE ENTRY 



UPDATE 
-Y DECB FIELDS 






Hr DID 
/REC'D INDEX 
\MATCH AN 
ACTIVE ENTRY 



EXITREST 



C 



J 



/ SET 'NO 

/ COMPARE' 

( BIT (3) IN 

\ DECFLAGS 



© 



DECREMENT ' 

USAGE 

COUNT 





r , 

/ DECREMENT 
-/ USAGE 
\ COUNT 




TURN ON RFT 
RECEIVED FROM 
GENERAL POLL 
CU FLAG IN 
IOBINCAM 



-C5- 



CONVERT REMOTE 
3270 RFT TO BTAM 
RFT 




I-J5 



TURN ON UE 
BIT IN IOBCSW; 
TURN ON IOB 
EXCEPTION BIT IN 
IOBFLAG1 
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Chart B5. Channel End Appendage (IGG019MB) (Part 5 of 6) 




( EXCEPTION V- 
\ BITS; SET / 

Verrorcodb^ 



( RETURN J 
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Chart B5A. Channel End Appendage (IGG019MB) (Part 6 of 6) 




COMPARE 
RECEIVED ID 
WITH 
EXPECTED ID 




ARE X YES 

ID'S EQUAL 



POINT TO 
FIRST 

AUTHORIZED 
SEQUENCE 



©" 




BSC LINE 
NO 



RESET ACK 
POINTERS 
IN EOB 



SET ' ID'S DID 
NOT MATCH' 
FLAG IN 
DECFLAGS 



REXITA 
D4) 




^ 






INDICATE 

WACK 

RECEIVED 

IN 

DECFLAGS 



RESET ACK 
POINTERS 
IN IOB 



INDICATE 
NOT ACK 
IN DECFLAGS 



INDICATE 

LINE 

CONNECTION 

IS 

ESTABLISHED 






STORE 
LIST ENTRY 
ADDRESS 



POINT TO 
NEXT 

AUTHORIZED 
SEQUENCE 





I NDI CATE 
DLE EOT 
RECEIVED 



POINT TO 
NEXT 

AUTHORIZED 
SEQUENCE 



STORE 
LIST ENTRY 
ADDRESS 





UPDATE 
RESTART 
ADDRESS TO 
DISCONNECT 
CCW 



© 




INDICATE 
RECEIVED ID 
DID NOT 
MATCH ANY 
AUTH SEQUENCE 



-K4— 
SET UNIT 
EXCEPTION & 
IOB 

EXCEPTION 
FLAGS 
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Chart B6. WTTA Channel End Appendage (IGG019PD) (Part 1 of 3) 



CEAPPWT 
_A3_ 



C 



J 



LOAD PCI 

APPENDAGE 

ADDRESS 



IGG019MC 



LOAD COMMAND 
ADDR. OF 
IOBCSW TAKE 8 
FROM ADRS TO 
POINT AT 
FAILING CCW 




LOAD ADDRESS 
OF THE PREVIOUS 
BUFFER 



STORE IT 
IN THE 
CSW 



EXIT 
r-J2- 



J33 

BRANCH TO 
<PROPER TP-OP 
CODE ROUTINE 



B7A1 (TP01 -PREPARE/SENSE) 

■ B7 A4 (TP07-READ TERM ID) 

■ B8 A2 (TP1 1 -READ OR WRITE TEXT) 
B8 A4 (TP23-WRITE BREAK) 



RESTORE 
REGISTERS 



C 



1 
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Chart B7. WTTA Channel End Appendage (IGG019PD) (Part 2 of 3) 




TURN OFF IOB 
EXCEPTION AND 
HALT I/O FLAGS 




TURN ON 
EOT FLAG 



DECREMENT 
TRANSMISSION 
COUNT BY 1 




REXITA 
C2 



INCREMENT 
CCW ADDRESS 
BY 8 



REXIT 
i-02- 



STORE IT 

IN IOB START 

ADDRESS 




TURN OFF 

IOB EXCEPTION 

FLAG 



RESTORE 
REGISTERS 



C 



RETURN (IOS 
RESTART 



+i)\ 



UPDATE 
DATA CHECK 
COUNTER 




UPDATE 
CCW FIELDS 



-E3- 

MOVE WRITE 
BREAK CCW 
IN THE CHANNEL 
PROGRAM AREA 



TP11I 
F3- 



SAVE SENSE 
AND CSW 
AND FAILING 
CCW 




TP11E 



-J3 

TURN ON 

IOB EXCEPTION 

FLAG 




SET NORMAL 
COMPLETION 
CODE X7F' 
IN IOB 



RESET 

TEMPORARY 

FLAG 




DECREMENT 
DATA CHECK 
COUNTER BY 1 



SET ON 

TEMPORARY 

FLAG 
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Chart B8. WTTA Channel End Appendage (IGG019PD) (Part 3 of 3) 



TPll 
A2- 



TURN OFF 

IOB EXCEPTION 

FLAG 




RESTORE SENSE 
AND CSW IN 
IOB 



TURN ON 

CONTENTION 

FLAG 




TURN ON 
EOT FLAG 



TURN ON 
WRU FLAG 




DECREMENT RES. 
COUNT BY 1 AND 
MOVE 1 LETTER 
SHIR IN BUFFER 



STORE RES. CNT 
IN IOB 
RESIDUAL COUNT 



TURN-OFF 
LOST DATA BIT 



G4' 

<DATA CHECK S 
OR 
.,,„, s overrun/ 




TURN ON 
SHOULD-NOT- 
OCCUR BIT 



TURN ON 

IOB EXCEPTION 

FLAG 
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Chart B9. Local 3270 Channel End/Abnormal End Appendage (IGG019PA) 
(Part 1 of 2) 








1 



/ TURN ON ERP \ 
< HAS BEEN > 

\ ENTERED BIT / 



I RETI 



RETURN TO IOS 



D 
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Chart E10. Local 3270 Channel Ena/Abnormal End Appendage (IGG019PA) 
(Part 2 of 2) 



/ RESET \ 

<IOBFLAG2 FIELD > 
X TO ZERO / 



-E2- 



/ RESET 

<IOBFLAG3 FIELD 
X TO ZERO 



-F2- 



/^ RESET 
/IOBSENSO AND 
< IOBSENS1 TO 
X ZERO 



/SET IOBERRCT 
<TO SHOW CE/XCE 
X RETRY 




RESET 
IOBE9BC9 TO 




€ 



RETURN TO IOS+4 



5 



IRETU1 



RETURN TO IOS+8 



5 
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Chart C1. Program Control Interrupt Appendage (IGG019MC) 



( IGG019MC V 



LOCATE CCW 
COMPUTE PTR TO 
BUFFER ROUTINE 




NO ir 



PURGE REQUEST 
FROM QUEUE 



PLACE READ-SKIP 
COMMAND IN 
NEXT CCW 



^ 



] y THIS LAST X NO 
^- BUFFER > 




ADJUST TIC 
ADDRESSES 



QUEUE REQUEST 
FOR ONE 
BUFFER 




ADJUST COUNT 
ADJUST TIC 
ADRS TO CCW 
AFTER LAST TIC 
IF ANY 




SETUP 

BUFFER ADDRESS 



( RETURN IOS J 
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Chart C2. Local 3270 First-Level Attention Routine (IECTATEN) 



(entry from ios J 
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Chart C3. Local 3270 Second-Level Attention Routine (IGG019PG) 



r~ "\ 

f ENTRY FROM AEE3J 



-B2- 



/ ESTABLISH 
/ CSECT 

(ADDRESSABILITY 
\ AND SAVE 

Return addr, 



ESTABLISH 

BASES FOR 

DEVICE AND 

MASTER UCB 

DSECTS 



ESTABLISH 
ADDRESSABILITY 
FOR DEB AND 
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Chart C4. Local 3270 BTAM SVC Boutine (IECTSVC) (Part 1 of 3) 
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Chart C5. Local 3270 BTAB SVC Routine (IECTSVC) (Part 2 of 3) 
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Chart C6. Local 3270 BTAM SVC Routine (IECTSVC) (Part 3 of 3) 
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Chart D1. On-Line Test Control (IGG019MR) (Part 1 of 5) 
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Chart D2. On-Line Test Control (IGG019MR) (Part 2 of 5) 
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Chart D3, On-Line Test Control (IGG019MR) (Part 3 of 5) 
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Chart D4. On-Line Test Control (IGG019MR) (Part 4 of 5) 
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Chart D5. On-Line Test Control (IGG019MR) (Part 5 of 5) 
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Chart D5A. Local On-Line Test Control (IGG019PI) (Part 1 of 2) 
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Chart E5B. Local On-Line Test Control (IGG019PI) (Part 2 of 2) 
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Chart D6« On-Line Test EBCDIC and USASCII/TRANSCODE Message (IGC0706F) (IGC0806F) 
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Chart EO. BTAM Start/Stop ERP Control (IGE0004A) 
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Chart El. Start/Stop ERP Data Check (IGE0104A) 
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Chart E2. Start/Stop ERP Time Out (IGE0204A) (Part 1 of 2) 
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Chart E2A. Start/Stop ERP Time Out (IGE0204A) (Part 2 of 2) 
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Chart E3. Start/Stop ERP Intervention Required (IGE0304A) (Part 1 of 2) 
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Chart E3A. Start/Stop ERP Intervention Required (IGE0304A) (Part 2 of 2) 
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Chart E<*. Start/Stop ERP Lost Data (IGE0404A) 
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Chart E5A. Start/Stop ERP Post (IGE0504A) (Part 1 of 2) 
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Chart E5B, Start/Stop ERP Post (IGE050UA) (Part 2 of 2) 
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Chart E6. Start/Stop ERP Bus Out Error Check (IGE0604A) 
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Chart E7. Start/Stop ERP Pead Skip Write Break (IGE010UA) (Load 1) 
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Chart E8. Start/Stop ERP Status Check (IGE0804A) 
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Chart E9. BTAM Start/Stop ERP Control (IGE0904A) (Load 2) 
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Chart FO. Start/Stop ERP Data Check (IGE0004B) (Load 2) 
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Chart Fl. Start/Stop ERP Diagnostic Write/Read (IGE0104B) 
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Chart F2, ERP Line Error Recording (Start/Stop and BSC) (IGE0204B) 
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Chart F3. Start/Stop ERP Unit Exception (IGE0304B) 
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Chart F4. Start/Stop ERP Read Skip Write Break (IGEOGOUB) (Load 2) 






J 






a 




<END, 
1ENDW 




A3 

' CHANNEL 
"~ DEVICE 
WITH UNIT 
"HECf 






INCREMENT 
COUNT 



EXECUTE 

CHANNEL 

PROGRAM 



f RETURN J 



G3 \. 

/ DECENTRY \NO 
X. ZERO / 



ERRCHK20 



SVC 3 




Charts 179 



Chart F5. Start/Stop ERP Overrun (IGE050UB) 
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Chart F6, ERP Intervention Required Message Writer (Start/Stop & BSC) (IGE0604B) 
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Chart F7. Line Error Print (IECTLERP) 
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Chart F8, ERP Channel Check £ Interface Control Check 
(Part 1 of 2) 
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Chart F9. ERP Channel Check S Interface Control Check (Start/Stop g BSC) (IGE080HB) 
(Part 2 of 2) 
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Chart G1A. BSC EBP Data Check (IGE0104C) (Part 1 of 2) 
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Chart GIB. BSC ERP Data Check (IGE010UC) (Part 2 of 2) 
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Chart G2A, BSC ERP Time Out (IGE0404C) (Part 1 of 2) 
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Chart G2B. BSC ERP Time Out (IGE0404C) (Part 2 of 2) 
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Chart G3. BSC ERP Intervention Required (IGE030«»C) 
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Chart G4. BSC ERP Lost Data (IGE0604C) 
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Chart G5A. BSC ERP Error Post (IGE0204C) (Part 1 of 2) 
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Chart G5B. BSC ERP Error Pest (IGE0204C) (Part 2 of 2) 
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Chart G5C. Hemote 3270 Error Post Routine (IGE0704B) 
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Chart G6. BSC ERP Control (IGE0004C) (Part 2 of 3) 
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Chart G9A. BSC EBP Equipment Check & Command Reject (IGE0804C) 
(Part 1 of 2) 
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Chart G9B. BSC ERP Equipment Check S Command Reject (IGE0804C) (Part 2 of 2) 
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Chart JOA. BSC ERP Special Return (IGE0504C) (Part 1 of 2) 
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Chart JOB. BSC ERP Special Return (IGE0504C) (Part 2 of 2) 
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Chart Jl. BSC ERP Bus Out £ Overrun (IGE0704C) 
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Chart J2A. BSC ERP Unit Exception Routine (IGE0904C) (Part 1 of 3) 
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Chart J2B. BSC ERP Unit Exception Routine (IGE0904C) (Part 2 of 3) 
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Chart J2C, BSC ERP Unit Exception Routine (IGE0904C) (Part 3 of 3) 
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Chart Kl. Change Entry (IECTCHGN) (Part 1 of 2) 
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Chart K2. Change Entry (IECTCHGN) (Part 2 of 2) 
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Chart LI. 2741 Break (IGG019PK) 



c 



j 



r-Bl • 
MOVE PREPARE 
COMMAND INTO 
CHANNEL 
PROGRAM 
AREA 



SVCO 



EXECUTE 

CHANNEL 

PROGRAM 



HALT I/O 
OPERATION 



C 



3 



206 



Chart Ml. Edit (IBM 50 Magnetic Data Inscriber) (IECTEDIT) (Part 1 of 5) 
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Chart M2. Edit (IBM 50 Magnetic Data Inscriber) (IECTEDIT) (Part 2 of 5) 
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Chart M3. Edit (IBM 50 Magnetic Data Inscriber) (IECTEDIT) (Part 3 of 5) 
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Chart M4. Edit (IBM 50 Magnetic Data Inscriber) (IECTEDIT) (Part 4 of 5) 
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Chart M5. Edit (IBM 50 Magnetic Data Inscriber) (IECTEDIT) (Part 5 of 5) 
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Chart TL. On-Line Test Request (IECTONLT) 
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Chart TO. On-line Test Control (Start/Stop) (IGC0006F) 
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Chart T01. On-Line Test Control (BSC) (IGC0D06F) 
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Chart T02. On-line Test Control (local 3270) (IGC1206F) 
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Chart Tl. IBM 1030 Terminal Test (IGC0106F) 
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C 



THE REQUIRED CHANNEL PROGRAM 
IS GENERATED IN THE CCW AREA OF 
THE IOB ASSOCIATED WITH THIS LINE. 

THE COMPARE TEST WAS PERFORMED BY 
THE HEADER ANALYSIS ROUTINE AND 
IF THE COMPARISON WAS VALID, THE 
COMPARE-VALID MESSAGE HAS OVER- 
LAID THE TEST REQUESTS MESSAGE. 
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Chart T2. IBM 1050 Terminal Test (IGC0206F) 



c 



j 





ADD 1 TO 
USAGE COUNT 




MSGSWTCH 

r _C4_ 



FIND IOBAND 
CCW AREA 





SETUP 
DIAL CCWS 



SETUP 

DATA 

CCW 



FINCCWS 
-H2 - 



FIND IOBAND 
CCW AREA 



-G3_ 



SET USAGE 
COUNT TO ONE 
MOVE DATA TO 
AREA 




SET UP DIAL 
CCW'S 



SETUP 
DATA 
CCW 



PUT EOT AT 
END OF THIS 
BUFFER 



SET UP 
OTHER CCWS 



f RETURN J 



NOTE 1: THE REQUIRED CHANNEL PROGRAM IS GENERATED IN THE 
CCW AREA OF THE IOB ASSOCIATED WITH THIS LINE. 

NOTE 2: RESTRICTION— IF THE USER PROGRAM HAS DEFINED AN 
ANSWERING LIST, IT MUST NOT UTILIZE THE RESET 
OPTIONS IN THE READ MACROS. THE LINE CONNECTION 
MUST REMAIN ESTABLISHED FOR THE TERMINAL TESTS. 

NOTE 3: THE COMPARE TEST WAS PERFORMED BY THE HEADER ANALYSIS 
ROUTINE AND IF THE COMPARISON WAS VALID, THE COMPARE- 
VALID MESSAGE HAS OVERLAID THE TEST REQUEST HEADER. 
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Chart T3. IBM 1060 Terminal Test (IGC0306F) 




FIND THE IOB 
AND SET UP 
LINE NUMBER 
CONTROL 
CCW'S 




.C5 

DETERMINE 
TERMINAL 
ADDRESS FROM 
POLLING 
LIST 



DETERMINE 
TERMINAL ADDR 
FROM PRE- 
DEFINED CODE 
IN HEADER 



" MESSAGE \ YES 



THE REQUIRED CHANNEL PROGRAM 
IS GENERATED IN THE CCW AREA 
OF THE IOB ASSOCIATED WITH 
THIS LINE. 





SET 'COMPARE 
VALID' 
MESSAGE IN 
PROGRAM 
I/O AREA 



SETUP 
SWITCH CCW'S 



(IECTONLT) 



COMPARE TEST SENDS RESPONSES 

TO ONLY THE REQUESTING TERMINAL. 
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Chart T<*. IBM 2740 Terminal Test (IGC0406F) 



MSGSWTCH 
,_A5_ 



SETCCWRG T4B1 



SETUP 
CCW'S 



T4E1 
NOTE 2 




IF THE COMPARE TEST WAS PERFORMED 
BY THE HEADER ANALYSIS ROUTINE 
AND THE COMPARE WAS VALID, THE 
'COMPARE VALID 1 MESSAGE HAS 
OVERLAID THE TEST REQUEST HEADER. 

THE REQUIRED CHANNEL PROGRAM IS 
GENERATED IN THE CCW AREA OF THE 
IOB ASSOCIATED WITH THIS LINE. 



(IECTONLT) 
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Chart T5. IBM 2848/2260 Terminal Test (IGC0504F) (Load 1) 



c 



D 



-Bl - 
FIND IOBAND 
CCW AREA. 
MOVE CCW'S 
INTO PLACE. 
FIND INP DATA. 




I — Dl - 

CONVERT DC & 
DS ADDRESSES 
FROM 2 DIGITS TO 
1 ASCII CHAR & 
PUT IN IOB 



REQADDRX 
-El — 



PUT STX EOT + 
OP IN IOB. 
COMPLETE 
ALL BUT DATA 
CCW 





COMPDONE 





WRATLINE 
r—E3 — 



CONVERT LINE 
ADDRESS AND 
PUT IT AT 
BEGINNING 
OF INPUT 





REQADDR 
-F3- 



ADD 1 TO 
USAGE COUNT 



SETDATA 
-Hl- 



NOTINUSE 
,_G2 



MOVE 
RESPONSE 
MESSAGE TO 
INPUT AREA 



GET MAIN 
STORAGE FOR 
THIS PATTERN 



SETUP 
DATA CCW 



[ RETURN J 



_G3_ 
PUT DC AND DS 
ADDRESS IN IOB, 
CONVERT TO 2 
ASCII DIGITS 
PUT IN MESSAGE 




MSGSWTCH 

F5 IS 
ETX IN 
THIS BUFFER 



SET USAGE 
COUNT TO 
ONE 




THE CHANNEL PROGRAM IS GENERATED IN 
THE CCW AREA OF THE IOB ASSOCIATED WITH 
THIS LINE. 
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Chart T6A. IBM 2848/2260 Terminal Test (IGC0606F) (Load 2) (Part 1 of 2) 



G 



j 



INITIALIZE 
REGISTERS AND 
WORK AREA 




GET ADDRESS OF 
DATA TO BE 
SWITCHED 



GETCOUNT T6BA5 



GET COUNT 
OF CHARACTERS 
IN BUFFER 



FOUNDIT 
-G2 





INCREMENT 
CHARACTER 
COUNT TO IN- 
CLUDE STX AND 
ETX 



SAVE IN CCW 



C 



D 



CALLING 
ROUTINE 



•Kl- 

PUT ETX IN 
LAST BUFFER 
POSITION 



-T RETURN J 



CALLING 
ROUTINE 



CONVERT T6BA1 



CONVERT TO 
BINARY 



DO MESSAGE 
PROCESSING 




SAVE DS A DDR 
FOR 2845 




NOT2265 

r C4- 



CONVERT T6BA1 



CONVERT TO 
BINARY 




FINISH 

MESSAGE 

PROCESSING 





J3- 

GET MESSAGE 

FOR 

2845/1053 
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Chart T6B. IBM 2848/2260 Terminal Test (IGC0606F) (Load 2) (Part 2 of 2) 



c 



T6AC3 
T6AC4 



D 



BI - 

CLEAR SECOND 

WORK 

REGISTER AND 

GET CHAR TO 

BE CONVERTED 




CA3- 



T6AC2 



J 



CLEAR 
WORK 
REGISTERS 



GET TENS 
CHARACTER 
AND 

CONVERT TO 
TENS FACTOR 



GET UNITS 
CHARACTER 
AND DROP 
ZONE BITS 



DEVELOP 

FINAL 

RESULT 



c 



J> 




f RETURN J 



T6AD3 
T6AD4 
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Chart T7. IBM 2741 Terminal Test (Correspondence Code) (IGC0906F) (PTTC Code) (IGC0A06F) 



c 



IGC0906F 
IGC0A06F 



■ B2- 



J> 



MOVE CCW'S 
INTO CHAN 
PROG AREA 




ADD 1 TO 
USAGE COUNT 



GET MAIN 
STG FOR 
PATTERN 



© 




MOVE IN TEST 
PATTERN AND 
SET USAGE 
COUNT TO 1 



SET COUNT 
AND ADDRESS 
OF PATTERN 
IN CCW 



FIND LENGTH 
OF TEXT 





ADJUST FOR 
CHAIN ADDRESS 
IN BUFFERS 




SET MSG 
LENGTH IN 
CCW 



MOVE IN 'CMP 
VALD' MESSAGE 
AND SET 
LENGTH 



< 



J 




C 



D 
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Chart T8. IBM 2760 Terminal Test (IGC0B06F) 




SECOND 

r-B2 — 



TURN OFF 
REENTRY FLAG 
INDECB 



_B3 

MOVE 3 CCW'S 
FROM WTIOCCWS 
INTO CHANNEL 
PROGRAM AREA 



WRITE EOA PADS NL PADS 
WRITE PROBE COORDINATES 
WRITE EOT 



FILL IN DATA 
ADDRESSES 
AND COUNTS 




INDICATE RESTART 
WITH READ 
CONVERSATIONAL 



INDICATE 
RESTART WITH 
READ INITIAL 



>■«- 




NOGOOD 
-F2 



INDICATE TEST 
NOT TO BE 
EXECUTED 
(IOBINCAM = 
X'00') 



-Gl- 
MOVE 5 CCW'S 
FROM TIOCCWS 
INTO CHANNEL 
PROGRAM AREA 



(SEE NOTE) 



FILL IN DATA 
ADDRESSES 
AND COUNTS 




(FRAME CHG) 



(SCAN PT) 



TURN ON 
COMMAND 
CHAIN FLAG IN 
LASTCCW 



-J2- 

MOVE 2 CCWS 

FROM RESPCCWS 

TO CHANNEL 

PROGRAM AREA- 

140 



PREPARE 
READ DATA 



FILL IN DATA 
ADDRESSES 
AND COUNTS 



GOODEXIT 
_G4 







INDICATE TEST 
TO BE EXECUTED 
(IOBINCAM = 
X'OP) 



f RETURN J 



NOTE: WRITE EOA PRE O 

WRITE FRAME CHANGE 
WRITE EOB 
READ RESPONSE 
WRITE EOT 



INDICATE THIS 
MODULE TO BE 
REENTERED 
(DECB +8 = X'80') 



Charts 223 



Chart T9. IBM 2740 Terminal Test (Correspondence Code) (IGC0C06F) 





,_ A5— i 



NOTINUSE 
A5 



GET ADDRESS 
OF DATA TO 
MOVE AND 
TABLE ENTRY 



PUTIN 

GETMAIN 

CONSTANTS 
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Chart T10. 3270 EBCEIC Test Module (Types 23 and 24) (IGC0E06F) 



GET ADDRESS OF 
CCW 


< 


' 



L 



© 



^— A3 . 

f IGC0E06F I 




GET MESSAGE 

LENGTH AND 

ADDRESS 




POINT MESSAGE 

ADDR PAST LINE 

CONTROL CHARS 



MOVE MESSAGE 

INTO USER'S 

BUFFER 




MOVE NOP 

COMMAND INTO 

CCW 







H 



SAVE THE ECB 



RESTORE THE ECB 



GED 
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Chart T11. 3270 EBCEIC Test Module (Type 25) (IGC1406F) 




POINT MESSAGE 

ADDR PAST LINE 

CONTROL CHARS 



© 



1 



STORE COUNT IN 
CCW 



SAVE THE ECB 



RESTORE THE ECB 



r^ — \ 

f SVC 3 1 



MOVE MESSAGE 

INTO USER T S 

BUFFER 
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Chart T12. 3270 EBCCIC Test Module (Types 26 and 27) (IGC0F06F) 



r~^ \ 

f IGC0F06F J 





GET MESSAGE 

LENGTH AND 

ADDRESS 



U 



© 





^TURN ON ERROR 
FLAG 




POINT MESSAGE 

ADDR PAST LINE 

CONTROL CHARS 



MOVE NOP 

COMMAND INTO 

CCW 



©^ 

&RTEST if 
, A 5-*- 



MOVE MESSAGE 

INTO USER'S 

BUFFER 



SAVE THE ECB 







RESTORE THE ECB 



c 



} 
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Chart T13. 3270 EBCDIC Test Module (Type 28) (IGC1306F) 



GET ADDRESS OF 
CCW 




NO S 










LOCAL 



SET COUNT TO 
ONE 



L 








„ c - ' 


1 


OVERLAY 
TRANSPARENT CCW 
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Chart T14. Remote 3270 ASCII Test Module (Types 29, 30, and 32) 
(IGC1006F) 



r~ A2 > ^ 

f IGC1006F 1 




SAVE THE ECB 



RESTORE THE ECB 



r~ ^ 

( SVC 3 1 
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Chart T15. Bemote 3270 ASCII Test Module (Types 31 , 33, and 34) 
(IGC1106F) 



r~ K2 n 

f IGC1106F J 




MOVE TEST 
MESSAGE INTO 
USER'S BUFFER 



SAVE THE ECB 



RESTORE THE ECB 



E4 J ^^ 

f SVC 3 1 
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Chart X. Local 3270 EEP Routine (IGE0010E) (Part 1 of 6) 

r~ A1 \ 

f IGE0010E J 
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Chart X. Local 3270 ERP Routine (IGE0010E) (Part 2 of 6) 



CKCECMDS 
YES 




224.8 



Chart X. 



Local 3270 EBP Routine (IGE0010E) (Part 3 of 6) 




UPDATE SENSE 

DATA IN STAT 

TABLE 



L 



YES 


FINDSTAT 


LOCATE STAT 
TABLE ENTRY 






UPDATE SENSE 

DATA IN STAT 

TABLE 



L B 
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Chart X, Local 3270 ERP Routine (IGE0010E) (Part 4 of 6) 




UPDATE SENSE 

DATA IN STAT 

TABLE 



UPDATE SENSE 

DATA IN STAT 

TABLE 
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Chart X. Local 3270 EBP Routine (IGE0010E) (Part 5 of 6) 





RECRTY i r 



UPDATE SENSE 

DATA IN STAT 

TABLE 



Li 








UPDATE SENSE 

DATA IN STAT 

TABLE 
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Chart X. Local 3270 EEP Routine (IGE0010E) (Part 6 of 6) 

r~ h2 ^ 

f FINDSTAT J 



PICK UP STAT 

TABLE ADDR FROM 

CVT 



PICK UP STAT 

TABLE INDEX 

FROM UCB 




I NCR STAT ADDR 

TO NEXT CTRL 

ENTRY 



^^— E3- 
f RETU 
( CAL 



3 



INCR INDEX TO 
NEXT SECTION 
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Chart Y. Local 3270 EBP Routine (IGE0110E) (Part 1 of 3) 



r~" > * 

f IGE0110E J 
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Chart I. Local 3270 ERP Routine (IGE0110E) (Part 2 of 3) 
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Chart Y. Local 3270 EEP Routine (IGE0110E) (Part 3 of 3) 




0- 



ccw 

HI- 

FINDSTAT 





LOCATE STAT 
TABLE ENTRY 



LOCATE STAT 
TABLE ENTRY 



L 



L, 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 1 of 19) 



/sc 



'SCAN ENTRY (AN! 
ENTRY - INITIAL 
HOUSEKEEPING) ' 



4DV 



ESTABLISH SINK, 

SOURCE, AND 

DACA 

ADDRESSABILITY 




SET STXHER ON, 
SET DACIND TO 

•03'X, MOVE STX 

TO SINK, BUMP 

SINK 




22<U16 



Chart Z. 3270 SCAN (IECTSCAN) (Part 2 of 19) 




NO 


XIS THIS\. 

^erase writetn. 
*^ operation ? j 

>»Xyes 

^0 


NO 






























LOCLWR \ r 


NO 




PUT COMMAND 

CODE ONE IN 

SINK, BUMP SINK 






PUT WRITE 

CONTROL 

CHARACTER IN 

SINK, BUMP SINK 











PUT COMMAND 
CODE OF FIVE IN 
SINK, BUMP SINK 



©. 



-E1- 

PUT WRITE 

CONTROL 

CHARACTER IN 

SINK, BUMP SINK 




-D4- 



PUT A SET 
BUFFER ADDRESS 

ORDER IN THE 

SINK, BUMP THE 

SINK 



PUT SET BUFFER 

ADDRESS ORDER 

IN SINK, BUMP 

SINK, PICK UP 

SOM POINTER 




CONVERT 

HEXIDECIMAL TO 

3270 BUFFER 



PUT A BLANK IN 

THE SINK, BUMP 

THE SINK 



HI- 
PUT A SET 
BUFFER ADDRESS 
ORDER IN SINK, 
BUMP SINK 



-H3- 



PUT A SET 
BUFFER ADDRESS 

ORDER IN THE 

SINK, BUMP THE 

SINK 



PUT 3270 BUFFER 
ADDRESS ZERO IN 
SINK, BUMP SINK 
TWO, DACSOMAD = 
ALLONES 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 3 of 19) 



CLEAR CURLIN, 

CURSAD.SET 

LINGRO TO 2260 

SCREEN WIDTH 





SET LINGRO TO 

REMAINDER OF 

SOURCE 





DECREMENT 15 BY 
FOUR 



CHARACTERS 






TURN OFF ALL 

FLAGS BUT 

PRIEN, SHRD 



f RET 
f CA 



J 



MOVE THE 

PRECEDING- 

CHARACTERS, 

BUMP THE SINK 

AND SOURCE 



NULL- 


--->13A5 


NL - 


--->14A1 


EM - 


-— >13A5 


SOM - 


-— >14A3 




— >13A5 


EOM - 


--->14A4 


ETX - 


--->14A5 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 4 of 19) 




PICK UP CURSOR 
FROM DACCRS, 

GET 3270 SCREEN 

WIDTH, FIGURE 

LINE NUMBER 



SET CURLIN TO 

LINE NUMBER, 

COMPUTE ADDRESS 

FROM LINE 

NUMBER 



L 








SET LINGRO TO 

REMAINDER OF 

2260 LINE 



SET LINGRO TO 

2260 SCREEN 

WIDTH 



0- 



CONVERT 

HEXIDECIMAL TO 

3270 BUFFER 



Lr 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 5 of 19) 




MOVE FULL GROUP 

TO SINK, BUMP 
SINK AND SOURCE 
BY GROUP COUNT 



INCREMENT 

CURSAD BY GROUP 

COUNT 






0- 

WITCH4 



SET CURSAD TO 

POINT TO LAST 

POSITION OF 

2260 SCREEN 



L 



PUT A REPEAT TO 
ADDRESS ORDER 

IN THE SINK AND 
BUMP THE SINK 



SET RETURN TO 

WITCH4, 

CHARACTER TO 

NULL 



CONVERT 

HEXIDECIMAL TO 

3270 BUFFER 



CONSTRUCT RTA 
ORDER ( S ) 



PUT A NULL IN 

THE SINK AND 

BUMP SINK 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 6 of 19) 



SET CURSAD TO 
POINT ONE PAST 

LAST 2260 
SCREEN POSITION 



06 _ 
B2>-* 



-B2- 



I E- 

I SET BUFFER 

I ADDRESS ORDER 

I IN SINK AND 

I BUMP SINK 



JOUTVEI 

I CONVERT 
IHEXIDECIMAL TO 
| 3270 BUFFER 




-D2- 



START FIEID, 

PROTECTED 

ATTRIBUTE IN 

SINK, BUMP SINK 

TWO 



PUT SET FIELD, 

ATTRIBUTE IN 

SINK, BUMP 

SINK, SET 

SOMHER ON 



SAVE ADDRESS OF 

SF IN SOMADD, 

INCREMENT 

CURSAD 




-G4- 



INCREMENT 

CURLIN, SET 

CURSAD TO NEXT 

LINE 



PUT SBA ORDER 

IN SINK, BUMP 

SINK 



CONVERT 

HEXIDECIMAL TO 

3270 BUFFER 



L, 



INCREMENT 

CURSAD ONE 

POSITION 



(3) 
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Chart Z. 3270 SCAN (IEC1SCAN) (Part 7 of 19) 



l A2 t 



sink 



3270 BUFFER 



PUT INSERT 

CURSOR IN SINK, 

BUMP SINK 




SET CURSAD ONE 

PAST 2260 

PORTION 



CONVERT 

HEXIDECIMAL TO 

3270 BUFFER 



PUT SBA IN 

SINK, BUMP 

SINK, SET 

CURSAD TO LAST 

2260 POSITION 




PUT SF, 

PROTECTED 

ATTRIBUTE IN 

SINK, BUMP SINK 

TWO 



STORE THE SOM 

ADDRESS IN 

DACSOMAD 




1 



SET CHARACTER 

TO NULL, RETURN 

TO NEXT 

SEQUENTIAL 

INSTRUCTION 





L 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 8 of 19) 



STORE CURSOR IN 

DACCRS. 

DECREMENT 15 BY 

FOUR 





PUT SBA IN 

SINK, BUMP 

SINK, CURS AD = 

END OF CURRENT 

2260 LINE 



CONVERT 

HEXIDECIMAL TO 

3270 BUFFER 




SET RTA IN 

SINK, BUMP 

SINK, CURS AD TO 

BEGINNING OF 

NEXT LINE 



CONVERT 

HEXIDECIMAL TO 

3270 BUFFER 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 9 of 19) 



SET SHRD OFF, 

SET CURLIN TO 

ZERO 






PUT 2260 DEVICE 
ADDRESS IN SINK 
AND BUMP SOURCE 
BY TWO, SINK BY 
ONE 



PUT AID IN SINK 





PUT END FRAMING 

IN SINK, BUMP 

SINK BY TWO 



PUT ETX IN 
SINK, BUMP SINK 



Ll 



u. 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 10 of 19) 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 11 of 19) 
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BETWEEN 2260 

AND 32 70 



SET LINGRO TO 

ACTUAL DATA 

LENGTH 




SAVE THE BRANCH 

ARGUMENT, SAVE 

SOMADD 




SOMADD TO 

REMAINING 
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STREAM 



J. 



LINGRO TO 

TESTED PORTION 
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MOVE TESTED 
PORTION LESS 

UNIQUE 

CHARACTER TO 

SINK 



BUMP SINK BY 

LINGRO, SOUR AD 

EQUAL UNIQUE 

CHARACTER ' S 

ADDRESS 



SAVE SOM 

ADDRESS IN 

CARADD, RESTORE 

THE BRANCH 

ARGUMENT 



NL 


>15A1 


NULL 
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FM 
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SMI 
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>16A3 


EOM 


>15A1 


ETX 


>16A4 


SOM 


>16A5 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 12 of 19) 




RESTORE SOURCE, 

SINK TO 

BEGINNING 



i— ►foT 
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SET LINGRO TO 

UNTESTED 

PORTION 






DIVIDE 

DISPLACEMENT OF 

SMI INTO SOURCE 

BY DSWIDE 



w 
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ANWIDE-DSWIDE 

TO GET NUMBER 
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-E5- 



ADD NUMBER OF 
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DISPLACEMENT 

INTO SOURCE OF 

SMI 





DECREMENT BY 

TWO TO REMOTE 

ADDRESS 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 13 of 19) 
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PUT BLANK IN 
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CURS AD. SET 
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MOVE THE TESTED 
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SINK, BUMP THE 
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L B 



SET SOMADD TO 

BUFFER ADDRESS 

OF SF, SET SOMP 

OFF, SET SOMHER 

ON 




POINT SOURAD TO 

BEGINNING OF 
NEXT 2260 LINE 



L 
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Chart Z. 3270 SCAN (IEC1SCAN) (Part 14 of 19) 
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PUT FIELD MARK 

IN SINK- BUMP 
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IN SINK, BUMP 

SINK 



CONVERT 

HEXIDECIMAL TO 

3270 BUFFER 
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L, 
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PUT START 

FIELD, 

ATTRIBUTE IN 

SINK, BUMP SINK 

TWO 
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PUT !, END 
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SINK, BUMP SINK 

TWO 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 15 of 19) 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 16 of 19) 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 17 of 19) 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 18 of 19) 
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Chart Z. 3270 SCAN (IECTSCAN) (Part 19 of 19) 
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APPENDIX A: OPERATING SYSTEM CONTROL BLOCK LINKAGES 



The System/360 Operating System provides 
interfaces among programs by means of 
control blocks and tables. These blocks 
have standardized formats. They contain 
numerous fields of information and 



references by the program. Some of these 
fields are pointers to other blocks. 
Figure 13 shows the various blocks and the 
linkages pertinent to 8TAM. 
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Figure 13, Control Block Linkages 
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APPENDIX B: DATA CONTROL BLOCK 



The data control block (DCP) provides 
information about its associated data set 
(in this case, a communication line group). 
Each such data set has a DCB. Expansion of 
the DCB macro-instruction at assembly time 
reserves storage for the DCB and 
initializes the DCB with parameters from 
the macro defining the DD name, the data 
set organization, the macros used for 
input/outout, and the exit list address. 



Other parameters can be defined by the 
DD cards in the job stream, or dynamically 
by the program modules at any time before 
the data set of the DCB is opened. (There 
must be at least one DD card for each DCB 
in the program. ) 

Figure 14 is a diagram of the DCB. 
Table 1 shows the contents and possible 
sources of each field. 



Displacement 
Hex Dec 

10 16 



World Trade 
Telegraph 34 52 
Interface 



DCBREAD 
DCWRITE 



DCBLERB 



14 20 
18 24 

1C28 

20 32 
24 36 

28 40 
2C44 
30 48 

28 40 
2C44 
30 48 



DCBBQFLG 



DCBWTEOM 



DCBWTEOT 



DCBWTPAD 



DCBBUFNO 


DCBBUFCB 


t 


DCBBUFL 


DCBDSORG 


Common 
Interface 


DCBDEVTP 


DCBICBAD 


1 



DCBBFTEK 


DCBERROP 


(reserved) 


* 

Foundation 


DCBEIOBX 


DCBEXLST 


Extension 



BTAM 
Interface 

I 



DCBDDNAM 



DCBOFLGS DCBIFLG 



DCBMACR 



38 56 




DCBXCODE 


BSC 


3C60 


DCBBSTSX 


Interface 
before 






Open 






(reserved) 





— I — 

Foundation 

before 

Open 

\ 



DCBTIOT 


DCBMACRF 


* 
Foundation 


DCBIFLGS 


DCBDEBAD 


after Open 
1 


DCBOFLGS 









38 56 


DCBXMODE 


DCBXCODE 


DCBBSRSV 


DCBBSWBT 






3C60 


DCBBSTSX 


DCBBSSTX 


DCBBSTEX 


DCBBSETX 




40 64 


DCBBSAK0 


DCBBSAK1 


BSC 
Interface 


44 68 


DCBBSENQ 


DCBBSNAK 


DCBBSETB 


DCBBSDLE 


afte 

1 


r open 


48 72 


DCBBSEOT 


DCBBSSYN 




4C76 


DCBBSONL 


DCBBSSAK 




50 80 


DCBBSRVI 


(reserved) 




54 84 


(reserved) 




58 88 


(reserved) 




5C92 


(reserved) 




60 96 


(reserved) 





Figure 14. Data Control Block (DCB) 
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Table 1. Data Control Block Fields (Part 1 of 3) 



Section 


Relative 
Loc 

IHADCB+ 
(DEC) 


Length 
(In bytes) 


Name 
DCB+ 


Contents 


World 
Trade 
Telegraph 
Interface 




16 

17 

18 

19 


16 


BQFLG 
WTEOM 
WTEOT 
WTTPAD 


(Reserved) 

World Trade telegraph flag byte 

The EOM character (WT telegraph terminals) 

The EOT character (WT telegraph terminals) 

Number of pad (LTRS) characters required for Motor-On delay (WT telegraph terminals) 


Common 
Interface 


20 

21 
24 

26 
28 
29 


1 

3 
2 

2 

1 
3 


BUFNO 

BUFCB 

BUFL 

DSORG 

DEVTP 

IOBAD 


Number of buffers to be obtained by Open (0-255). 

Address of buffer control block. 

Buffer length (the length of buffers to be obtained by open for a buffer pool, and/or the length 
to be used if the length parameter of a READ or WRITE macro is coded as 'S') 0-32760. 

Data set organization (a communication line-group specification of CX sets bit 3) 

Index to device entry in device I/O directory. 

IOB Address (the address of the first IOB, the IOB for line 1, minus the length of an IOB 
(DCBEIOBX). The IOB address for any line associated with this DCB is equal to DCBIOBAD 
plus the product of the line number and DCBEIOBX value.) 


Foundation 
Extension 


32 


1 


BFTEK 


Buffering technique (Bit 4-dynamic buffering). 
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Table 1. Data Control Block Fields (Part 2 of 3) 



Section 


Relative Loc 
IHADCB + 


Length 
(in bytes) 


Name 
DCB+ 


Contents 




33 


1 


ERROP 


Error recovery procedures. The EROPT parameter inthe DCBwill cause one or more of the following 

bit codes to be set. 

Bit Bit Value Code in ERROPT and Meaning 

3 1 T Specifies that the on-line test facility is to be used for the line group. This 

option is valid forall IBM stations , with or without error recovery procedures. 

4 1 C Specifies that threshold error counts and cumulative error counts are to be 

maintained in the line error recording block (LERB) for data check, intervention 
required, and non-text timeout errors. 


Foundation 
Extenstion 
(Continued) 








5 1 W Specifies that text-write errors are to be retried ir. addition to the basic error 

recovery procedures. This option is valid for all start-stop terminals except 
World Trade telegraph terminals. It is invalid for BSC stations. It results in an 
additional copy of the message for each retry (except for the 2260 with the line 
address feature and the 1050 card punch and paper tape punch with the line 
correction feature). This parameter is ignored for BSC stations and WT telegraph 
terminals. 

6 1 R Specifies that text-read errors are to be retried in addition to the basic error 

recovery procedures. This option is valid only for the following terminals: 
1050 terminals (valid for the card reader and paper tape reader only if the 
line correction feature is installed), 2740 terminals with the checking feature, 
and 2260 terminals. 

7 1 N Specifies that no error recovery procedures are to be provided for the line group. 

This parameter and E,R,W, and C are mutually exclusive. This parameter is 
invalid for BSC stations; if coded, it is ignored. 

7 E Specifies that the basic error recovery procedures (JERP) are to be provided for 
' the line group. If EROPT is omitted, E is assumed. 




34 


1 


BUFCT 


Maximum number of buffers to be obtained by BTAM for a Read operation (dynamic buffering). 




35 


1 




RJE requesting no retries. 




36 


1 


EIOBX 


Extended IOB index (size of lOB's associated with this DCB). 




37 


3 


EXLST 


Exit list (the address of a user-provided list that may contain an entry, control code and address, for 
a DCB exit). 


Foundation 

before 

Open 


40 


8 


DDNAM 


Data definition name as used in DD statement (used by open to locate the appropriate DD entry in the 
task I/O table). 




48 


1 


OFLGS 


Flags used by OPEN. 

Bit 3 - OPEN: This bit set on when an OPEN has been successfully completed. 
Bit 6 - LOCK: This bit is set on by an I/O support function if the DCB is to be processed by 
that function. 




49 


1 


IFLG 


Used by IOS in communicating error conditions and in determining error procedures. 




50 


2 


MACR 


Macro instruction reference (specifies major macros and various options associated with^them. 
Used by Open to determine access method. Not used by BTAM). 
Bit 2 - Read ) DTA .. 
Bit 10 -Write ] BTAM 


Foundation 
after Open 


40 


2 


TIOT 


Points to the DD entry in the task I/O table for this DCB. It is the offset of the DD entry relative 
to the beginning of the task I/O table. 




42 


2 


MACRF 


Same as MACR. 




44 


1 


IFLGS 


Same as IFLG. 




45 


3 


DEBAD 


Address of the associated DEB. 




48 


1 


OFLGS 


Same as OFLGS above. 


BTAM 
interface 


49 
49 


3 
3 


READ 
WRITE 


\ Address of Read- Write module. 




52 


4 


LERB 


Address of line error recordinq block. The LERB address is specified by the DCB parameter LERB. 
This field is present if C or T is specified in the DCB parameter EROPT. 
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Table 1 . Data Control Block Fields (Part 3 of 3) 



Section 


Relative Loc 
IHADCB + 


Length 
(in bytes) 


Name 
DCB+ 


Contents 




56 




XMODE 


Mode of transmission for binary synchronous communication (BSC). 

Bit Bit Value Meaning 

Reserved . 

1 1 Intermediate block checking is to be performed. 

The transmission control unit will recognize the EIB 
character and perform block checking without turning the line 
around. 

2 1 Transmission Is through a 2701 Data Adapter Unit Dual Communication 

Interface B. 

3 Reserved . 

4 1 Transmission is in code B for a 2701 Data Adapter Unit Dual Code 

Feature . 
5-7 Reserved . 




57 


1 


XCODE 


BSC control station flag and transmission code. 
Bit & State 


BSC 

Interface 
(after 
Open)* 








0123 4567 

This is the control station. 

1 This is the remote station . 

.... 00. . EBCDIC transmission code is used. 
..1. 1... 6-bit TRANSCODE is used. 
...1 .1.. USASCII is used. 

. 1 . . . .XX A synchronous exit is to be taken to processor-to-processor 
(PTOP) FORTRAN data processing routine (before open only) 




58 




BSRSV 


DLE control character. 




59 




BSWBT 


(reserved) 




60 




BSTSX 


DLE control character (before Open, BSTSX is a 4-byte field containing address of 
PTOP interface resolution routine, if PTOP is specified at system generation). 




61 




BSSTX 


STX control character. 




62 




BSTEX 


DLE control character. 




63 




BSETX 


ETX control character. 




64 


2 


BSAKO 


ACK-0 control character. 




66 


2 


BSAK1 


ACK-1 control character. 




68 




BSENQ 


ENQ control character. 




69 




BSNAK 


NAK control character. 




70 




BSETB 


ETB control character. 




71 




BSDLE 


DLE control character. 




72 




BSEOT 


EOT control character. 




73 




BSSYN 


SYN control character. 




74 




BSTBE 


DLE control character. 




75 




BSTEB 


ETB control character. 




76 


2 


BSONL 


SOH% control sequence. 




78 


2 


BSSAK 


WACK control sequence (X'106B'-EBCDIC, X'103B'-USASCII) 




80 


2 


BSRVI 


DLE @ control sequence. 




82 


18 


— 


(reserved) 


* Before Op 


>en, BSC inter 


Face conta 


'ns DCBXC 


ODE and DCBBSTSX fields only. 
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APPENDIX C: DATA EXTENT BLOCK 



Displacement 
(Dec) 



One data extent block (DEB) is created in 
protected storage by open module 1 for each 
line group (data set) . The DEB contains a 
table of IOS appendage addresses , unit 
control block addresses for each line 
or local 3270 device, and addresses of 
other control blocks. The DEB also 
includes a list of the identifications 
of all BTAM modules needed to support 
the devices in the line group. Figure 
15 is a diagram of the DEB, Table 2 shows 
the contents of each field, giving source 
codes where known. 



-36 


DEBEOEA 


App 
Tab 


. 


-32 


DEBSIOA 




-28 


DEBPCIA 


endage 


-24 


DEBCEA 


e 


-20 


DEBXCEA 








NOT USED B^ 




■ 








Pre 


i 


-8 


DEBDCBMK 


fix 


-4 


DEBLNGTH 


Reserved 







DEBNMSUB 


DEBTCBAD 


Basic 




+4 


DEBAMLNG 


DEBDEBAD 




+8 


DEBOFLGS 


DEBIRBAD 




+12 


DEBOPATB 


DEBQSCNT 


Reserved 


DEB 


+16 


.DEBNMEXT 


DEBUSRPG 


+20 


DEBPRIOR 


DEBECBAD 




+24 


DEBPROTG 
DEBEBID 


DEBDCBAD 




+28 


DEBEXSCL 


DEBAPPAD 




+32 


Reserved 


PEBUCBAD 


Devi 






TABLE OF 

= n* UCB ; 

ADDRESSES 


ce 


32+(4xn) 


ADDRESS OF BUFFER ROUTINE 


Dependent- 

1 
Access 
> Merhod 


36+(4xn) 


ADDRESS OF FIRST CCW ON QUEUE 


40+(4xn) 


ADDRESS OF LAST CCW ON QUEUE 






44+(4xn) 


DEBSUBID 


-Subrou 








rine ID 



*n = number of extents 



Figure 15, Data Extent Block (DEB) 
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Table 2. BTAM DEB Fields 



Section 



Source 



Location 
IECTDEB+ 



Size 

(in bytes) 



Name 
DEB+ 



Contents 



Appendage 
Table 



G 
G 



-36 

-32 

-28 

-24 
-20 



EOEA 

SIOA 

PCIA 

CEA 
XCEA 



Address of end of extent appendage branched to by I OS 
(not used by BTAM). 

Address of start I/O appendage branched to by IOS (not 
used by BTAM). 

Address of program control led interrupt appendage 
branched to by IOS. 

Address of channel end appendage branched to by IOS. 

Address of abnormal end appendage branched to by IOS. 



DCBMK 
LNGTH 



DCB modification mask used by I/O Support. 
Length of DEB in doublewords. 



Basic 



G 
F 
F 
F 





1 

4 

5 

8 

9 
12 
13 
16 
17 
20 

21 
24 

24 1/2 
25 
28 



1 

3 
1 

3 
1 

3 
1 

3 
1 

3 
1 

3 

1/2 
1/2 
3 



NMSUB 

TCBAD 

AMLNG 

DEBAD 

OFLGS 

IRBAD 

OPATB 

QSCNT 

NMEXT 

USRPG 

PRIOR 

ECBAD 

PROTG 

DEBID 

DCBAD 

EXSCL 

APPAD 



Number of subroutines I coded by open executor. 

TCB address for this DEB. 

Number of bytes in Access Method Section. 

Address of next DEB in the same task. 

Data set status flag (not used by BTAM). 

IRB address for error exit (not used by BTAM). 

Indicates file type (not used by BTAM). 

Number of devices executing user channel programs. 

Number of extents (number of lines in the line group) . 

Address of first IOB in user purge chain. 

Priority of the task. 

Address of a parameter list used to locate the 
purge ECB for an SVC purge request. 

Protection tag assigned to this task. 

Hex "F" identifies this block as a DEB. 

Address of DCB associated with this DEB. 

Extent seal e = 2 for communication devices indicating 
4 bytes per extent (used to determine size of device 
dependent section). 

Address of I/O appendage table preceding DEB. 



Device 
Dependent 



32 



(Note 1 ) 



UCBAD 



Table of addresses of UCBs for each of n* lines or 
local 3270 devices. 



Access Method 
Dependent 



32+(4xn) 
36+(4xn) 
40+(4xn) 



Address of buffer routine (loaded when dynamic 
buffering or buffer pool specified). 

Address of first CCW on queue (optional; required 
only when dynamic buffering is specified). 

Address of last COW on queue (optional; required 
only when dynamic buffering is specified). 



Subroutine ID 



44+(4xn) 



(Note 2) 



SUBID 



2- character subroutine IDs (last two characters of 
8- byte name). 



* n = number of extents . 

Note 1: Size = NMEXT shifted left logical EXSCL bits (in this case, 4 bytes/extent). 

Note 2: Size = 2 X NMSUB bytes. 
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APPENDIX D: INPUT/OUTPUT BLOCK 



The input/output control block (IOB) 
provides communication between BTAM and 
IOS. It is the sole parameter of the IOS 
execute channel program (EXCP) instruction. 
One IOB is created for each communication 
line by open module 1. 

The basic IOB, 64 bytes in length, 
contains pointers to the channel program, 
the event control block, and the terminal 
lists; it provides areas for storing flags, 
sense bytes, the channel status word, and 



the start I/O condition code returned by 
IOS. Appended to each fcasic IOB is a 
variable length area where the channel 
programs are constructed by the read-write 
routine. 



Figure 16 shows details of the channel 
status word (CSW) field and Figure 17 is a 
diagram of the IOB. Table 3 contains 
descriptions and sources of the contents of 
the IOB fields. 






7 


8 






31 


IOS Flags 


CCW ADDRESS 


Control Unit and 
Device Status 


Channel 
Status 


Count 



32 



39 40 



47 48 



63 



8-31 Address of Last CCW+8 





r 32 


Attention 




33 


Status Modifier 


Control Unit 


34 


Control Unit End 


and Device , 
Status 


35 


Busy 


36 


Channel End 




37 


Device End 




38 


Unit Check 




L 39 


Unit Exception 





40 


PCI 




41 


Incorrect Length 




42 


Program check 


Channel 
Status S 


43 


Protection check 


44 


Channel data check 




45 


Channel control check 




46 


Interface control check 




47 


Chaining check 



J 48-63 Residual count difference between 
Count / number of characters sent or 

I received and length specified. 



Figure 16. IOB CSW Field 
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16 
20 
I 24 
28 
32 

36 
40 

48 
64 



IOBFLAG1 



IOBECBCC 



IOBFLAG3 



IOBFLAG2 IOBSENS0 IOBSENS1 



IOBECBPT 



IOBCSW 



IOBSIOCC 



Reserved 



OP 

Code 



IOBSTART 



IOBDCBPT 



IOBRESTR 



IOBINCAM 



IOBUCBX IOBWORK 



IOBERRCT 



IOBRCVPT 



IOBSNDPT 



IOBERCCW 



IOBERINF 



IOBCPA 



Channel Program Area 



Basic 
IOB 



BTAM 
Extension 



Figure 17. Input/Output Control Block (IOB) 
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Table 3. BTAM IOB Fields 



Relative 


Length 


Name 




Location 


(in bytes) 


IOB+ 


Contents 





1 


FLAG1 


Flag byte 1 

Bit - Data chaining in channel program 

1 - Command chaining in channel program. 

2 - Error recovery procedure is in control of current operation. 

3 - (not used by BTAM) 

4 - (not used by BTAM) 

5 - Exceptional condition. After ERP routine returns and this bit is on, the error is considered 

permanent. 

6 - Unrelated (I/O requests need not be scheduled FIFO). (This bit is always on for BTAM.) 














7 - Start/restart (IOS is to use channel program address IOBSTART (0) or IOBRESTR (1) (This bit 








is always for BTAM, unless the IOB is for a local 3270 device.) 


1 


1 


FLAG2 


Flag byte 2 

Bit Meaning 

°\ 

1 ) Not used by BTAM. 

2 J 

3 Extended message flag (indicator for IOS message writer routine) 














4-6 Not used by BTAM. 








7 RESETPL macro instruction was used. 


2 


1 


SENSO 


One byte of sense data stored here when a unit check error occurs. 
All zeros means successful completion. 
Bit - Command reject 

1 - Intervention required 

2 - Bus out check 

3 - Equipment check 

4 - Data check 

5 - Overrun 

6 - Lost data 

7 - Time-out 


3 


1 


SENS1 


Second sense byte (local 3270 display system only). 

If the sense data for IOBSENS0 could not be obtained for a local 3270 device, this byte 

contains X'FE 1 . 


4 


1 


ECBCC 


Completion code for an I/O event as it will appear in the first byte of the ECB. 


5 


3 


ECBPT 


Address of event control block (ECB) associated with this I/O request. 


8 


1 


FLAG3 


IOS error routine flags. 


9 


7 


CSW 


The channel status word is stored here at channel end time (low-order 7 bytes). 


16 


1 


SIOCC 


The condition code from execution of start I/O is stored here. 


17 


3 


START 


Address of the first CCW at which to start I/O for normal conditions. 


20 


1 




Reserved 


21 


3 


DCBPT 


Address of the DCB associated with this IOB. 


25 


3 


RESTR 


Address pf CCW at which to start I/O for restart operations. 


28 


2 


INCAM 


Bit Meaning 

Byte 0: SAD or ENABLE issued by OPEN resulted in a permanent I/O error. 

If the IOB is for a local 3270 device, this bit indicates that OPEN did not initialize 
the device, because it was being used by OLTEP. 

1 This IOB is currently in use by an I/O operation (IOB busy). 

2 RVI was received. Turned on when RVI sequence is received. 

Turned off when the next proper positive acknowledgment (ACK-0 or ACK-1) 
is received. 

3 Turned on, after a remote 3270 RFT message has been received, to indicate that 
the message cam from a control unit capable of a general poll. 

4 Reserved. 

5 Turned on after a remote 3270 error status message has been processed. (The error 
status message begins with SOH % R and provides status information about a remote 
3270 device.) 

6 Reserved. 

7 Line is currently under on-line test operation. 
Byte 1 : Used by BTAM for timer value (OPEN and LOPEN). 


30 


2 


ERRCT 


Error counter (local 3270 display system only). 

Byte 0: The local 3270 ERP uses this byte to keep a count of retry attempts. 

Byte 1 : 

Bits 0-4 - The local 3270 ERP uses these bits as flags during retry attempts. 

Bits 5-7 

State Meaning 

000 If bit 5 of IOBFLAG1 is off, the local 3270 ERP has recovered from the error. 
If bit 5 of IOBFLAG1 is on, the local 3270 ERP has not processed the error. 

010 The local 3270 ERP could not recover from the error. 
The problem program must reconstruct the buffer image. 

011 The local 3270 ERP determined that the error is permanent and nonrecoverable. 

110 The local 3270 ERP determined that the channel program or data stream builder 
of the problem program can recover from the error. 

111 The local 3270 ERP determined that the local 3270 channel end/abnormal end 
appendage should perform retry. 

101 The local 3270 channel end/abonormal end appendage is attempting to 
recover from the error by retrying the channel program. 


32 


1 


UCBX 


UCB index (line number-used as index to appropriate UCB address in the DEB). 


33 


5 


WORK 


Work area used by BTAM Error routines and On-Line Test Routines. 


38 


1 


RCVPT 


Received ACK (ACK-0 or ACK-1). 


39 


1 


SNDPT 


Sent ACK (ACK-0 or ACK-1). 


40 


8 


ERCCW 


CCW area used by BTAM error recovery routines. | The contents of these 

> fields vary 


48 


16 


ERINF 


Error information field used by the BTAM error recovery routines. J unpredictably 


64 




CPA 


Channel program area (length depends on type of stations or line configuration). 
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APPENDIX E: 



EVENT CONTROL BLOCK 



After initiating an I/O operation, the task 
(user program) in control can continue 
processing until it needs the results of 
that operation. At this point, the task 
issues a WAIT macro instruction, which 
signals the supervisor that the task cannot 
proceed until completion of a specified 
event (i.e., the I/O operation). The WAIT 
specifies an event control block (ECP) 
address, which is the first word of the 
data event control block (DECB) formed by 
expansion of a READ or WRITE macro 
instruction. Figure 18 shows the ECP after 
the WAIT was issued. Bit is the wait 
flag, and bit 1 is set on completion. Bits 
8 through 31 specify the address of the 
program request block. 



41 I/O Error . All channel end/device 
end/unit check conditions,, dIus 
program check, protection check, or 
chaining check conditions* This 
completion code also includes unit 
exception and incorrect length 
status if they occur in combination 
with one of the preceding error 
conditions. Status is present in 
the sense byte (IORS£NS0) only if a 
unit check condition has occurred. 

**** I/O Re qu est Rejected . A device 

error was detected after the last 
I/O operation on the device was 
posted complete. 



1 



31 



1 







PRB Address 



48 



Enable Command Halted or I/O 



Operation Purged , 
the following: 



Tndicates one of 



Figure 18. ECB After WAIT 



The supervisor posts completion of the 
event by setting the wait fiag off and the 
completion flag on. It inserts a 
completion code in bits 2 through 31 
(Figure 19) . 



An enable command (automatic 
answering function for a 
switched-connection line) was 
terminated by halt I/O as a 
result of a RES^TPL macro 
instruction (second operand 
omitted or specified as 
ANSRING). 



1 2 



7 8 



31 






1 


Completion 
Code 






Figure 19. ECB After Post 



COMPLETION CODES : Upon completion of an 
I/O operation, bits 2 through 7 of the 
event control block (ECB) in the DECP 
contain a completion code specified by the 
input/output supervisor. Bit (the wait 
flag) is zero, bit 1 (the completion flag) 
is one, and bits 8 through 31 are zero. 
The first byte of the ECB (bits through 
7) contain one of the following 
"completion" codes in hexadecimal notation: 

Code Meaning 

7F Normal Completion a Channel 

end/device end status; may include 
either unit exception, incorrect 
length, or both. 



A Read Initial operation for a 
World Trad** telegraph terminal 
was terminated by a Halt I/O as 
a result of a R^SETPL macro 
instruction (second operand 
omitted) . 



A Read Initial operation for 
a local 3270 display station 
was terminated as a result of 
a RESETPL macro instruction 
(second operand omitted or 
specified as ATTEtfT) . 

An enable command was 
terminated as a result of 
closing (CL.OPE macro 
instruction) a line group with 
enable commands outstanding. 



An I/O operation was purged at 
channel end interrupt time as a 
result of closing with I/O 
operations still in procrress. 
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APPENDIX F; DATA EVENT CONTROL BLOCK 



The data event control block (DECB) is 
formed in the user program at assembly time 
by expansion of a READ or WRITE macro 
instruction of the list or standard form. 
It provides communication with the BTAM 
read-write module, specifying operation 
type, line group, line or local 3270 
device, and terminal list. Areas for 
the standard ECB and responses to 
addressing and IRC checks are also included 
in the DECB. The format of the block 
is shown in Figure 20. The contents of 
its fields are shown in Table 4. 






DECSDECB 




4 


DECTYPE 


DECLNGTH 




8 


DECONLTT 
DECDCBAD 




12 


DECAREA 




16 


DECSENSO 


DECSENS1 


DECCOUNT 




20 


DECCMCOD 


DECENTRY 




24 


DECFLAGS 


DECRLN 


DECRESPN 




28 


DECTPCOD 


DECERRST 


DECCSWST 




32 


DECADRPT 


PRESENT 


36 


DECPOLPT 


ONLY 


40 


RESERVED 


DECWLNG 


) IN DECBS 
> FORBSC 
) LINES 


44 


DECWAREA 



Figure 20. Data Event Control Block (DECB) 



236 



Table 4. BTAM DECB Fields (Part 1 of H) 



Location 


Length 


Name 






IECTDECB+ 


(in bytes) 


DEC + 


Contents 







4 


SDECB 


Event control block (ECB) for this I/O request (see Appendix E). 




4 


2 


TYPE 


Operation types: 










1st byte: bit - Current operation is a read operation 












using Auto Poll 












bit 1 - if 1, RJE requested WTO time-out message 












suppression 












bit 4 - if 1 , Write Inquiry macro was issued 


> in any co 


mbination 








bit 5 - Entry coded as 'S' 












bit 6 - Area coded as 'S' 












bit 7 - Length coded as 'S' 












Operation 










2nd byte, bits 3,4,5, Value Operation Type Type Code 
6,7 

00 Write Break TB 


















01 Read Initial Tl 










02 Write Initial Tl 










03 Read Continue TT 










04 Write Continue TT 










05 Read Conversational TV 










06 Write Conversational TV 










07 Read Repeat TP 










Read Continue with Identification 










Exchange TE 










08 Write Positive Acknowledgment TA 










09 Read Skip TS 










0A Write Neg Acknowledgment TN 










Write Disconnect (TWX) TN 










Write Reset (BSC) TR 










0B Read Buffer TB 










0C Write at L.ne Address Tl 










Write Initial Optical (2740 T10 










w/Checking & 2760, or w/Checking, 










Dial-up & 2760) 










Write Initial Transparent Block (BSC) 










0D Write Initial Conversational TIV 










Read Continue with Leading 










Acknowledgment TTA 










0E Wnte Erase TS 










Write Initial Optical (2740 TCO 










w/Checking & 2760, or w/Checking, 










Dial-up & 2760) 










Write Continue Transparent Block (BSC) TTE 










OF Write Continue Conversational TTV 










10 Write Disconnect TD 










1 1 Read Connect TC 










Read Modifiea (Local 3270) TM 










12 Write Initial Transparent TIX 










Write Conversational Optical (2740 TVO 










w/Check.ng, Dial-up & 2760) 










Write Unprotected Erase (Local 3270) TUS 










13 Read Continue with Leading Graphics TTL 










Read Buffer from Position (Local 3270) TBP 










14 Write Continue Transparent TTX 










15 Read Inquiry TQ 










16 Write Inquiry TQ 










17 Read Repeat with Leading Graphics TPL 










18 (Reserved) 










19 Read Initial Inquiry TIQ 










Read Modified from Position (Local 3270) TMP 










1A Write Wait Before Transmitting TW 










IB Read Interrupt TRV 










1 C Write Connect TC 










ID Write Initial Conversational TIVX 










Transparent 










1 E Read Connect with Tone TCW 










IF Write Continue Conversational TTVX 










Transparent 










bit - Specifies reset for type code TIR, TTR, TVR, TLR, TSR, TIXR 










TPR, TTXR. 










'Bits 1 and 2 are reserved. , 




6 


2 


LNGTH 


Buffer length or message area length 




8 


1 


ONLTT 


When BSC on-line test is in control, the and 
1 bits have the following meanings; 

bit - if 0, on-line test was requested by RFT message, 
if 1, on-line test was initiated by ONLTST marro 

bit 1 - if 0, test messages are sent by BTAM 

if 1, test messages are received by BTAM 




9 


3 


DCBAD 


Address of the associated DCB. 




12 


4 


AREA 


Address of message area or first buffer. 




16 


1 


SENSO 


Sense information, as set by the control unit, when the CSW status (DECCSWST) indicates a 
Unit Check. 

Bit Meaning 

Command re|ect 

1 Intervention required 

2 Bus out check 

3 Equipment check 

4 Data check 

5 Overrun 

6 Lost data 

7 Timeout 




17 


1 


SENS1 


(Reserved) 




18 


2 


COUNT 


Residual count from the CSW for the last CCW that was executed. 




20 


1 


CMCOD 


Command code, identifies the type of command upon which the error occurred. 




21 


3 


ENTRY 


Address of a terminal list. 
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Table 



BTAM DECE Fields (Part 2 of 4) 



Location 
IECTDECB+ 



Length 
(in bytes) 



Name 
DEC+ 



Contents 



24 



FLAGS 



25 
25 



RLN 
RESPN 



Status flags which may be set regardless of whether there was an I/O error (i.e. , the completion 
code in the DECSDECB may be either 7F or 41). 

Bit 0: For start-stop operations, this bit is reserved. For BSC operations, it indicates that a WACK 
(wait-before-transmit) was received, if bit 1 is also on. If bit 1 is not on, bit indicates 
that an error status message was received. (An error status message begins with SOH % S 
and provides status information about a remote station.) 

Bit 1: For start-stop operations, this bit is reserved. For BSC operations, if indicates that some 

response other than ACK-0 or ACK-1 was received into the DECRESPN field. Examination 

of the response will determine which action should be taken to reestablish proper communication. 

(This bit is set when WACK (see also bit 0) is received or when RVI (see also bit 6) is received. 

Bit 2: For start-stop operations, this bit is reserved. For BSC operations, it means that an 

incorrect alternating acknowledgment was received: ACK-1 received when ACK-0 was 
expected, or vice versa. If this bit is on and the completion code for the operation is 7F 
(i.e., no line transmission error occurred), a complete message has been lost. 

Bit 3: The ID received from a TWX 33/35, or a BSC station did not equal the expected ID as defined 
in the terminal list specified in the WRITE Tl, WRITE TC, or READ TC macro instruction, or the 
index received as a result of an Auto Poll operation did not match the index byte in any of the 
active entries in the polling list. For BSC (nonswitched line) this bit on indicates that 
contention has occurred and this Is not the control station. For WT telegraph, this bit on 
indicates that contention occurred, or that a received ID differs from expected ID in terminal 
list specified by READ TE macro. 

Bit 4: No buffer was available upon completion of a dynamic buffering read command. The last 
buffer is posted complete and the remainder of the message is read from the communications 
line (under control of a dynamic buffering read skip command), but the data is not placed 
into storage. 

Bit 5: Indicates one of the following: 

1. A negative response to polling has been received from the terminal represented by 
the last active (nonskip) entry in an open polling list (OPENLST). 

2. A negative response to polling has been received following a RESETPL macro instruction 
of the POLLING type (second operand omitted or specified as POLLING). 

3. All of the entries in a wrap around polling list (WRAPLST) are inactive (all the skip bits 
are on). 

Note: Condition 3 can occur only as a result of one or more skip bits being turned on 
after initiation of a programmed polling operation, with a wrap around polling 
list. If all skip bits were on at the time that the READ macro instruction was 
executed, no I/O operation would be initiated. 

4. Negative response to addressing has been received. 

5. The last message sent from a WT telegraph terminal was ended by EOT or a timeout. 

6. 2741 power off or other Intervention Required condition. 

Bit 6: 2741 : Write operation was ended by terminal interrupt. 
WT telegraph: Message ended with WRU signal. 

BSC stations: A reverse Interrupt (RVI) sequence was received (see also bit 1). 
Remote 3270: If bit 6 is on, but bit 1 is not on, an error status message was received. (The 

error status message begins with SOH % R and provides status information 

about a remote 3270 device.) 

Bit 7: WT telegraph: The last message sent from a WT telegraph terminal ended with WRU. 
BSC stations: The STX ENQ sequence was received. 
Local 3270: OLTEP is using the device to run diagnostics. 

Relative Line number. 

1st byte, response to terminal addressing; 2nd byte, response to LRC/VRC check. 
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Table a. BTAM DECB Fields (Part 3 of 4) 



Locations 
IECTDECB+ 



Length 
(in bytes) 



Name 
DEC+ 



Contents 



28 



TPCOD 



TP-Op code. Bits 2-J of these codes identify types of commands that are not identifiable 
by the command code alone. Bits and 1 are used in conjunction with, but independently 
of, bits 2-7, as described below. 



Hex value 

00 
01 



02 



03 



04 



05 
06 
07 
08 



09 



Meaning 

Any command issued by on-line test routine or for a local 3270 device. 
Disable, when disable is the first command of a channel program 
Dial 
Enable 
Prepare 

Write EOA EOT EOT EOT 
Write graphics 

Write wait before transmitting 
Sense (WT telegraph) 

Write EOA EOT EOT EOT prior to selection 
Write EOT sequence prior to polling or addressing 
Write response to text 

Write EOA and 15 idle characters (Basic 2740) 
Write EOAPREo 

Write polling or addressing characters or /character (/ is the broad- 
cast addressing character) (2740 w/Station Control) 
Poll 

Write turnaround sequence (TWX) 
Write CPU-ID sequence (TWX and BSC) 
Write ENQ (BSC) 
Write WRU j 

/ (World Trade telegraph terminals). 



Write ID 

Write Pad characters 



Write letters shift characters/ 

Write space (2740 w/Station Control) 

Write 2848 command (2260R) 

Write FIGS shift (83B3) 

Write 1 (1030) 

Sense (2740) 

Read response to polling 

Read response to addressing 

Read ID response (TWX, BSC, WT Telegraph) 

Write end of addressing character following addressing (1030, 1050, 

1060, 2260R, 2740) 

Write response to inquiry (BSC) 

Write response to text (BSC) 

Write EOB (2760) 

NOP or TIC following Poll in READ with SSALST, SSAWLST, 

AUTOLST, or AUTOWLST 
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Table 4. BTAM DECB Fields (Part 4 of U) 



Location 
IECTDECB+ 



Length 
(in bytes) 



Name 
DEC+ 



Contents 



28 



TPCOD 



29 



ERRST 



30 
32 
36 



CSWST 
ADRPT 
POLPT 



40 
42 

44 



WLNG 



WAREA 



(Continued) 



Hex Value 

0A 

OB 
0C 
10 
11 
12 
13 

20 
21 
22 
23 

24 



25 



Meaning 

Read Index (Auto Poll) 

Read response to polling (programmed polling) 

Read inquiry (BSC) 

Read response to inquiry (BSC) 

Write at line address (2260R) 

Read or write text; Write frame change sequence (2760) 

Read skip or TIC for dynamic buffering 

Write end of transparent text characters (DLE ETX) 

(BSC) 

Read response to text (Start-Stop) 

All reset commands 

Read skip 

Write break 

Any command issued during OPEN, LOPEN, or 

CLOSE (Set Address, Enable, Disable, and Set 

Mode commands) 

Read response to text (BSC) 



In addition to the TP-Op codes, bits and 1 may be set to zero or one. A 1 in the 
indicated bit has the following meaning: 

bit the command just executed was the last command in the 
channel program. (For on-line tests, the command just 
executed was the last of the initialization commands |j.e., 
prior to Read Text or Write Text commands J ). 

bit 1 the command just executed was the first Read or Write Text 
command executed in the channel program using Dynamic 
Buffering. (For BSC on-line test, the command just 
executed was an initialization command Qi.e. , not a Read 
Text or Write Text command ]] . ) 

Error status flags which may be set if an I/O error has occurred (i.e. , a completion 
code of 41 in the DECSDECB). 

Bit 0: The START I/O instruction resulted in a condition code of 3, indicating that 
the control unit or the specified line address is not operational. 

Bit 1 : An error condition which should not occur (is undefined for the particular 
command or device) has occurred. 

Bit 2: An error condition occurred on an I/O operation initiated by the error recovery 
routines as an intermediate recover procedure, as part of diagnostic write/ 
read procedure (2701 only), or as part of a disconnect procedure for a 
switched line. 

Bit 3: A diagnostic write/read operation terminated in error, indicating a control unit 
failure (2701 only). An error occurred that makes the integrity of the device 
regeneration buffer doubtful (local 3270 only). 

Bit 4: A disable command was issued to a switched line by the error recovery routines 
after detection of a permanent error on that line. 

Bits 5-7: (Reserved) 

The status bits from the CSW for the last CCW that was executed. 

Pointer to the addressing list entry used in the previous operation. 

For programmed polling, pointer to the current entry in the polling list which will 
point to the terminal to be polled. For Auto Poll, the first byte contains an index 
identifying the current entry in the polling list and the last three bytes contain a 
pointer to the beginning of the polling list. 

For BSC on-line test, pointer to the user-specified text data provided in ONLTST 
macro [_ for test types 00 and 01 J. ) 

(Reserved.) 

Length in bytes of the data area (in leading-graphics, conversational, or READ TCW 
operations). (BSC only) 

Address of the data area (in leading graphics, conversational, or READ TCW 
operations). (BSC only) 
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APPENDIX G: UNIT CONTROL BLOCK 



Displacement 
(DEC) 



A unit control block (UCB) is built for 
each line or local 3270 device at system 
generation time and is used by IOS during 
execution to determine physical locations. 
The only field requiring the attention 
of the BTAM user is the device type word, 
which gives details of the terminals on 
the line or local" 3270 device: control 
unit, adapter, model, and optional 
features. This word is fully described in 
Appendix H. Figure 21 shows the format of 
the UCB. Table 5 shows the contents of the 
UCB. 






SRTEJBNR 
Internal Job No. 


SRTECHAN 
Allocation 
Channel Mask 


UCBID 
Identifier 


SRTESTAT 
status Byte A 


4 


UCBCHA 
Channel Address 


UCBUA 
Unit Address 


UCBFL1 
Flag Byte 1 


UCBDTI 

Device Table Index 


8 


UCBETI 

Error Routine Key 


UCBSTI 

Statistics Table 
Index 


UCBLCI 
Channel Table 
Index 


UCBATI 

Attention Table Index 


12 


UCBWGT 
Flags and Mask 


UCB NAME 

Unit Name 


16 


UCBTYP 

Communications Equipment or Graphics Device Type 


20 


UCBLTS 

Last Request Element 


UCBSNS 

Sense Information 


24 


Additonal 
Optional Features 


Attention 
Count 


Control 
Byte 


28 


IRB Address 


32 


Initialized 
RLN 


(reserved) 


36 


Device 
Index 


Control Block Link 



Graphic 

*- Devices 

Segment 



Figure 21. Unit Control Block (UCB) 
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Table 5, BTAM UCB Fields 



Relative 
Location 
(DEC) 


Size 

(in bytes) 


Name 


Contents 







SRTEJBNR 


Internal job identification. 


1 




SRTECHAN 


Allocation channel mask. 


2 




UCBID 


UCB identification - hex FF. 


3 




SRTESTAT 


Status byte A. 


4 




UCBCHA 


Channel address. 

Bit - Halt I/O has been issued. 

Bit 1 - Status modifier. 

Bit2"S 

Bit 3 ) reserved. 

Bit 4 J 

Bit 5^ 

Bit 6 / channel address (binary). 

Bit 7 J 


5 


1 


UCBUA 


Unit address. 


6 


1 


UCBFL1 


Flags: Bit - UCB busy (set at SIO, reset at DE). 

1 - UCB not ready (awaiting operator intervention). 

2 - Post flag (waiting DE or error at DE will be passed at next SIO). 

3 - Job intercept 

4 - Control unit busy 

5 - When bits 5 & 6 are 01, indicates HIO command is inhibited because channel program 

is already in progress. 

6 - Enable command has completed. 

7 - I/O error routine is in control of the line. 


7 




UCBDTI 


Index to Device Table (one entry/device type). 


8 




UCBETI 


Index used to get error routine for this device. 


9 




UCBSTI 


Index to Statistics Table. 


10 




UCBLCI 


Index to Logical Channel Table. 


11 




UCBATI 


Index to Attention Table. 


12 




UCBWGT 


Flags & channel mask. 


13 


3 


UCB NAME 


Unit Name (EBCDIC) 


16 


4 


UCBTYP 


Device type, (see Appendix H). 


20 


2 


UCBLTS 


Last request element. 


22 


2 


UCBSNS 


Sense information. 


24 


2 




An extension of the optional features byte in the UCBTYP field (local 3270 display system only). 
Byte 0: Bit - magnetic card reader adapter. 

Bit 1 - selector pen. 

Bit 2 - numeric lock. 

Bits 3-8 - reserved. 
Byte 1: Bits 0-8 - reserved. 


26 


1 




If the device index is one, this byte contains the number of attentions not serviced in the line group; 
otherwise, this byte is reserved (local 3270 display system only). 


27 


1 




Attention handling flags (local 3270 display system only). 

Bit - OLTEP executing flag. If this flag is one, the device is being used by OLTEP. 

Bits 1-4 - reserved. 

Bit 5 - read initial pending flag. 

Device index is one: If this flag is one, a Read Initial is outstanding and waiting for an attention 
interruption. If this flag is zero, and the initialized RLN field is nonzero, the second-level 
attention routine was scheduled to start a read operation. 

Device index is not one: This bit is reserved. 
Bit 6- skip flag. If this flag is one, a Read Initial for the device is ignored. 
Bit 7 - attention flag. If this flag is one, an attention interruption was received from the device. 


28 


4 




Address of the interruption request block (IRB) that points to the second-level attention routine (local 
3270 display system only). 


32 


1 




Initialized relative line number (local 3270 display system only). 

Device index is one: If this byte is zero, no Read Initial is pending for the line group. If this 
byte is one through 255, it is the relative line number of the IOB initialized by the BTAM 
Read/Write routine for a pending Read Initial. 
Device index is not one: This byte is reserved. 


36 


1 




The device's relative line number, which is an index to the table of UCB addresses in the DEB (local 
3270 display system only). 


37 


3 




Control block link (local 3270 display system only). 

Device index is one: This field contains the address of the DEB for the line group. 

Device index is not one: This field contains the address of the UCB with a device index of one. 
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APPENDIX H: UCB DEVICE CODES 



The device type word (UCBTYP) field located at relative location on hex 16 in the unit 
control block (UCE) has the forirat and content shown below. 









UCBTYP 






Byte 




Byte 2 




Byte 3 


Byte 4 


IOS Flags I 


Model Code j 


Optional Features 


1 


Device Class | 


Unit Type 



UCB+ 16(10) 



17(11) 



Offset Bytes and Bit and 
Dec Hex Alignment State 



16 (10) 1 

Byte 1 



xxxx 

.1.. 
• .1. 
..0. 
...1 



xxxx 



Hex. 

Dig. 



18(12) 



19(13) 



Field Description , Contents/ Meaning 

I/O Supervisor flags 

(Reserve^ bit) 

Overr unable device. 

Burst mode. 

Byte mode. 

Data chaining. 

Model Code 

The value in this field and the value in the 

adapter type field (byte 4, bits 0-3) 

together identify the model. 

Adapter 
Type Model 





0001 


-1 


1- 
2- 
3- 
4- 
5- 
6- 
8- 


1050 

1030 

1050 

83B3 

TWX 

WTTA 

2260 


... . 


0010 


-2 


1- 

4- 


1060 

11 5A 


• . • • 


0011 


-3 






.... 


0100 


-4 


1- 


2740 


... . 


0101 


-5 


1- 

9- 


274K 

BSCl 


... . 


0110 


-6 


1- 
9- 


27ar 
BSC2 





0111 


-7 


9- 


BSC3 


xxxx 


xxxx 




Model 


Code 


C0C1 


0001 


11 


Model 


1 


0001 


0010 


12 


Model 


2 



: (Correspondence code) 
(Nonswitched point-to-point) 
> (PTTC/BCD or EBCD code) 
(Switched point-to-point) 
(Nonswitched multipoint) 
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Offset Bytes and Bit and 
Dec Hex Alignment State 



17 (11) 



. 1 
Byte 2 



1... 

1.. 
1. 
1. 



1 

10 
01 
11 



Hex. 
Dig* 



Field description. Contents, Meaning 
Optional features. 

Automatic calling. 

Automatic polling. 

Checking (2740 only) 

Dual communication interface (2701 SDA-II) 

Automatic answering. 

Dual code (2701 SDA-II) 

Station control (2740 only) 

Transmit control (2740 only) 

2760 Attachment. 



.xx 



Binary 
Value 

SADZER 

1 SADONE 

2 S».DTWO 

3 SADTHREE 



XXX. . 


• . 


000. 


• • . 


001. . 


• . . 


010. 


, . m 


011. . 


• . . 


100. 


• . • 


101. , 


• .. • 


110. 


• • • 



XXX. 

000. 
001. 
010. 
011. 
100. 
101. 



0000 0000 



Keyboard Type (local 3277 display station) 

No keyboard 

66-key EBCDIC typewriter keyboard 

78-key EBCDIC typewriter keyboard 

66-key data entry keyboard 

78-key operator console keyboard 

66-key ASCII typewriter keyboard 

78-key ASCII typewriter keyboard 

Audible Alarm (local 3277 display station) 

Character Generator Type (local 3277 

display station) 

Domestic character generator 

ASCII A character generator 

ASCII B character generator 

United Kingdom character generator 

French character generator 

German character generator 

Character Generator Case (local 3277 

display station) 

Monocase character generator 

Hote: See byte 24 of the 0CB for additional 
optional features (local 3277 display station) 

No Optional Features (local 3277 display statioi 
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Offset Bytes and Bit and 
Dec Hex Alignment State 



Hex. 
Dig. 



Field description, Contents , Meaning 



18 (12) • . 1 
Byte 3 



Device Class. 
40 Coirmunication equipment. 
10 Graphics. 



19 (13) . . . 1 
Byte a 



1- 
2- 
3- 
4- 
5- 
6- 
7- 
8- 
9- 



-1 
-2 
-3 



Adapter Type. 

IBM Terminal Adapter, Type I. 
IBM Terminal Adapter, Type II. 
IBM Telegraph Adapter. 
Telegraph Adapter* Type I. 
Telegraph Adapter, Type II. 
World Trade Telegraph Adapter. 
Synchronous Adapter, Type I. 
IBM Terminal Adapter, Type III. 
Synchronous Adapter, Type II. 

Control Unit 

2702 

2701 

2703 



Unit Type (local 3270 display system) 
09 3277 display station 
0A 3284 printer 
0B 3286 printer 
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APPENDIX I: INTERBUPTION REQUEST BLOCK 



The interruption request block (IBB) is 
used to maintain information about an 
asynchronously executed routine. 



If on-line testing is re 
is, T was coded among the E 
in the DCB macro instructio 
that points to the on-line 
module is created and initi 
each line group during open 
line group contains local 3 
this 1KB is created by IGGO 
to IGG019PI ; otherwise, it 
by IGG0193S and points to I 



quired (that 
BOPT options 
n) , an IRB 
test control 
alized for 
(If the 
270 devices, 
194Q and points 
is created 
GG019MR.) 



If the line group contains local 3270 
devices, the BTAM Open executor (module 
TGG0194Q) also creates and initializes 
an IRB that points to the local 3270 
second-level attention routine (module 
IGG019PG) . 

Figure 22 shows the format of the IRB. 
Table 6 shows the contents of the IRB. 



Displacement 



4 



96 
100 





RBTMFLD 


RBPPSAV 




RBABOPSW 




RBWCSA 


RBSIZE 


RBSTAB 




RBEP 




RBOPSW 




RBUSE 


RBIQE 




RBWCF 


RBLINK 




RBGRSAVE 




RBNEXAV 







IQE Work Space 



Figure 22. Interruption Request Block (IRB) 



Relative 


Length 


Name RB+ 




Location 


(Bytes) 




Contents 





1 


TMFLD 


Flags for the timer routines. 


1 


3 


PPSAV 


Address of the problem program's register save area. 


4 


4 


ABOPSW 


After execution of the ABTERM routine, contains bits 32-63 of the user's old PSW. 


8 


1 


WCSA 


Wait count save area. 


9 


1 


SIZE 


Size of this IRB in doublewords. 


10 


2 


STAB 


Status and attribute bits. 


12 


4 


EP 


Entry-point address of the asynchronously executed routine. 


16 


8 


OPSW 


User's old PSW. 


24 


1 


USE 


Use count used by ATTACH. 


25 


3 


IQE 


List origin for interruption queue elements (IQEs). 


28 


1 


WCF 


Number of requests waiting (wait count). 


29 


3 


LINK 


Address of the previous IRB on the queue; or the address of the TCB if this IRB is first on 
the queue. 


32 


64 


GRSAVE 


General register (0-15) save area. 


96 


4 


NEXAV 


Address of the next available IQE. For local 3270 attention handling, RBNEXAV 
contains IRB+100 if the IQE is available or if it is not. 


100 






IQE work space. For local 3270 attention handling, contains one IQE. 



Table 6. BTAM IRB Fields 



Appendix I: UCB Device Codes 244.3 



APFSNDIX J: INTEBBUPTIQN_QUEUE ELEMENT 



The interruption queue element (IQE) is 
used to schedule an asynchronously executed 
routine. 

If on-line testing is required (that 
is, T was coded among the EEOPT options 
in the DCB macro instruction) , IQEs are 
created and initialized during open, 
(If the line group contains local 3270 
devices r these IQEs are created fcy 
IGG0194Q; otherwise, that are created 
by IGG0193S.) 

If the line group contains local 3270 
devices, the BTAM Open executor (module 
IGG0194Q) also creates and initializes 
an IQE in the IQE work area of the IRB 
that points to the local 3270 second-level 
attention routine. 



Displa 



4 

8 
12 
16 

20 



(reserved) 


IQELNK 


IQEPARAM 


(reserved) 


IQEIRB 


(reserved) 


IQETCB 


RPLTCB 


(reserved) 


RPLSZPQE 



Rollout/ 
^Rollin 
Parameter 
List 
(Optional) 



Figure 23. Interruption Queue Element (IQE) 



Figure 23 shows the format of the IQE, 
Table 7 shows the contents cf the IQE, 



Relative 
Location 


Length 
(Bytes) 


Name 


Contents 


1 

4 

9 

13 

16 

21 


3 
4 
3 
3 
4 
3 


IQELNK 

IQEPARAM 

IQEIRB 

IQETCB 

RPLTCB 

RPLSZPQE 


Address of the next IQE on the queue. 

The parameter that is to be passed to the asynchronously executed routine. 

Address of the IRB that points to the asynchronously executed routine. 

Address of the TCB for the task executing the asynchronous routine. 

Address of the TCB for the task requiring or releasing an extension to a region. 

Size of the region requested (rollout) or address of the PQE describing the area (rollin). 



Table 7. BTAM IQE Fields 
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APPENDIX K: LIST OF ETAM MODULES 



This appendix lists all of the routines and 
modules composing BTAM; they are listed by 
module name (alphabetically) and by name of 
routine. 

All modules whose names begin with IECT 
reside in the SYSl.TtLCMLIB library; all 
others reside in the SYS1.SVCLIE library. 



Listed Alphabetically by Module Name 



(* Following a naire indicates a device I/O 
module rather than an executable routine) 

Module 

Name Name of Routine 

| IECATEN Local 3270 First-Level 

Attention Routine 
IECTCHGN Change Entry 
IECTEDIT Edit (IBM 50 Magnetic Data 

Inscriber) 
IECTLERP Line Krror Print 
IECTLOPN Line Cpen 
IECTONLT On-Line Test Request 
| IECTSVC Local 3270 BTAM SVC Routine 
IECTTRNS Translate 
IGC058 REQBUF/RELBUF (SVC 58) 

IGC0006F On-Line Test Control 

(Start-Stop) 
IGC0106F IBM 1030 Terminal Test 
IGC0206F IBM 1050 Terminal Test 
IGC0306F IBM 1060 Terminal Test 
IGC0406F IBM 2740 Terminal Test 
IGC0506F IBM 2848/2260 Terminal Test 

(Load 1) 
IGC0606F IBM 2848/2260 Terminal Test 

(Load 2) 
IGC0706F USASCII and Transcode Test 

Message 
IGC0806F EBCDIC Test Message 
IGC0906F IBM 2741 Terminal Test 

(Correspondence Code) 
IGC0A06F IBM 2741 Terminal Test (PTTC 

Code) 
IGC0B06F IBM 2760 Terminal Test 
IGC0C06F IBM 2740 On-Line Test 

(Correspondence Code) 
IGC0D06F On-Line Test Control (BSC) 
IGC0E06F 3270 EBCDIC Test Module 

(Types 23, 24) 
IGC0F06F 3270 EBCDIC Test Module 

(Types 26, 27) 
IGC1006F Remote 3270 ASCII Test 

Module (Types 29, 30, 32) 
IGC1106F Remote 3270 ASCII Test 

Module (Types 31, 33, 34) 



IGC120 6F On-Line Test Control 

(Local 3270) 
IGC1306F 3270 EBCDIC Test Module 

(Type 25) 
IGC1406F 3270 EBCDIC lest Module 

(Type 28) 
IGE0004A BTAM Start-Stop ERP Control 

(Load 1) 
IGE0004B Start-Stop ERP Data Check 

(Load 2) 
IGE0004C BTAM BSC ERP Control 
IGEC104A Start-stop ERP Data Check 

(Load 1) 
IGE0104B Start-Stop ERP Diagnostic 

Write/Read 
IGE0104C BSC ERP Data Check 
IGE0204A Start-Stop ERP Time Out 
IGE0204B ERP Line Error Recording 

( Start- Stoo S BSC) 
IGE0204C BSC ERP Error Post 
IGE0304A Start- Stop ERP Intervention 

Required 
IGE0304B Start-Stop ERP Unit 

Exception 
IGE0304C BSC ERP Intervention 

Required 
IGE0404A Start-Stop ERP Lost Data 
IGE0404* Start-Stop ERP Read 

Skip/Write Break Check (Load 

2) 
IGE0404C BSC ERP Time Out 
IGE0504A Start-Stop ERP Error Post 
IGE0504B Start- Stop ERP Overrun 
IGE0504C BSC ERP Special Return 
IGE0604A Start-Stop ERP Bus Out 
IGE0604* ERP Intervention Required 

Message Writer (Start-Stop 

and BSC) 
IGE0604C BSC ERP Lost Data 
IGE0704A Start-Stop ERP Read 

Skip/Write Break Check (Load 

1) 
IGE0704B Remote 3270 Error Post 

Routine 
IGE0704C BSC ERP Bus Out and Overrun 
IGE0804A Start-Stop ERP Status Check 
IGE0804^ ERP Channel Check and 

Interface Control Check 

(Start- Stop and BSC) 
IGE0804C BSC ERP Equipment Check and 

Command Reject 
IGE0904A BTAM Start-Stop ERP Control 

(Load 2) 
IGE0904C BSC ERP Unit Exception 
IGG0193*! BTAM Open Executor (Load 1) 
IGG0193Q BTAM Open Executor (Load 3) 
IGG0193S BTAM Open Executor (Load 4) 
IGG0194N BTAM Open Executor (Load 2) 
IGG0194P Local 3270 BTAM Open Executor 
IGG0194Q Local 3270 BTAM Open Executor 
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IGG019MA 
IGG019M* 

IGG019MC 

IGG019MD 
IGG019MF 

IGG019MF 
IGG019MI 
IGG019MJ 
IGG019MK 
IGG019ML 
IGG019MN 
IGG019MP 
IGG019MR 
IGG019MS 
IGG019MT 
IGG019MU 
IGG019MV 



IGG019MW 

IGG019MX 

IGG019MY 

IGG019MZ 

IGG019M0 
IGG019M1 

IGG019M2 



BTAM Read/Write 

Channel End/Abnormal End 

Appendage 

Program Controlled Interrupt 

(PCI) Appendage 

IBM 1050, Nons witched* 

IBM 105 0, Nonswitched (Auto 

Poll)* 

IBM 1050, Switched* 

IBM 1060* 

IBM 1030* 

IBM 1030 (Auto Poll)* 

ATST 83B3* 

WTJ 115A* 

WIT TWX 33/35* 

On- Line Test Control 

Buffer 

IBM 2740, Basic* 

IBM 2740, Dial-up* 

IBM 2740, Dial-up, with 

Transmit Control and 

Checking* 

IBM 2740, Dial-up, with 

Transmit Control* 

IBM 2740, Dial-up, with 

Checking* 

IBM 2740, with Station 

Control and Checking* 

IBM 2740, with Station 

Control* 

IBM 2740, with Checking* 

IBM 2740, with Station 

Control and Checking (Auto 

Poll)* 

IBM 2740, with Station 

Control (Auto Poll)* 



IGG019M3 IBM 2260 (Remote)* 
IGG019M4 IBM 1060 (Auto Poll)* 
IGG019M5 Nonswitched Point-to- Point* 
(BSCD* 

IGG019M6 Switched Point-to-Point* 

(BSC2)* 
IGG019PA Local 3270 Channel End/ 

Abnormal End Appendage 
IGG019PB World Trade Telegraph 

Terminals* 
IGG019PC Nonswitched Multipoint* 

(BSC3)* 
IGG019PD World Trade Telegraph 

Terminal Channel 

End/ Abnormal End Apoendage 
IGG019PE IBM 2741, Nonswitched* 
IGG019PF IBM 2741, Switched* 
IGG019FG Local 3270 Second-Level 

Attention Routine 
IGG019PH Local IBM 3270* 
IGG019PI Local On-Line Test Control 
IGG019PK 2741 Break 
IGG019PL IBM 2740, with Checking and 

2760 Attachment* 
IGG019PM IBM 2740, Dial-up, with 

Checking and 2760 

Attachment* 
IGG019PN IBM 10 50, Jonswitched* 
IGG019PO IBM 1050, Switched* 
IGG019PP IBM 2740, witii Checking* 
IGG019PQ IBM 2740, Dial-up with Checking* 
IGG0203H ^TAM Close iJxecutor 



*As specified in the UNIT operand of the 
IODEVICE macro instruction. 



II. Listed by Routine 



Module 

Name of Routine Name 

BTAM Open Executor (Load 1) IGG0193M 

BTAM Open Executor (Load 2) IGG0194N 

BTAM Open Executor (Load 3) IGG0193Q 

BTAM Open Executor (Load 4) IGG0193S 

Local 3270 BTAM Open Executor IGG0194P 

Local 3270 BTAM Open Executor IGG0194Q 

BTAM Read/Write IGG019MA 

Channel End/Abnormal End Appendage IGG019MB 
World Trade Telegraph Terminal Channel End/Abnormal End Appendage IGG019PD 

Local 3270 Channel End/Abnormal End Appendage IGG019PA 

Program Controlled Interrupt (PCI) Appendage IGG019MC 

Local 3270 First-Level Attention Routine IECTATEN 

Local 3270 Second-Level Attention Routine IGG019PG 

Local 3270 BTAM SVC Routine IECTSVC 
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2741 Break 

Buffer 

REQBUF/RELBUF (SVC 58) 

Change Entry 

Edit (IBM 50 Magnetic Data Inscriber) 

Line Error Print 

Line Open 

Translate 

BTAM Close Executor 



IGG019PK 

IGG019MS 

IGC058 

TECTCHGN 

IECTEDIT 

IECTLERP 

IECTLOPN 

IECTTRNS 

IGG0203M 



On- Line Test Routines: 
On-Line Test Request 
On-Line Test Control 
I Local On-Line Test Control 
| On-line Test Control (Local 3270) 
On-Line Test Control (Start- Stop) 
On-Line Test Control (BSC) 
IBM 1030 Terminal Test 
1050 Terminal Test 
1060 Terminal Test 
Terminal Test 
Terminal Test 
Terminal Test 
Terminal Test 
2760 Terminal Test 
2848/2260 Terminal Test (Load 1) 
2848/2260 Terminal Test (Load 2) 
USASCII and Transcode Test Message 
EBCDIC Test Message 

3270 EBCDIC Test Module (Types 23 r 24) 
Test Module (Types 26, 27) 
ASCII Test Module (Types 29, 
ASCII Test Module (Types 31, 
Test Module (Type 25) 
Test Module (Type 28) 



2740 
2740 
2741 
2741 



IBM 
IBM 
IBM 
IBM 
IBM 
IBM 
IBM 
IBM 
IBM 



3270 EBCDIC 
Remote 3270 
Remote 3270 
3270 EECDIC 
327C EBCDIC 



(Correspondence Code) 
(PTTC Code) 



30, 
33, 



32) 
34) 



IECTONLT 
IGG019MR 
IGG019PI 
IGC1206F 
IGC0006F 
IGC0D06F 
IGC0106F 
IGC0206F 
IGC0306F 
IGC0406F 
IGC0C06F 
IGC0906F 
IGC0A06F 
IGC0B06F 
IGC0506F 
IGC0606F 
IGC0706F 
IGC0806F 
IGC0E06F 
IGC0F06F 
IGC1006F 
IGC1106F 
IGC1306F 
IGC1406F 



BTAM Error Recovery Procedures (ERP) : 



Common (Start-Stop S BSC) Routines: 
Line Error Recording 
Intervention Required. Message Writer 
Channel Check & Interface Control Check 



IGE0204B 
IGE0604B 
IGE0804B 



Start-Stop ERP Routines: 

BTAM Start-Stop ERP Control (Load 1) 

BTAM Start-Stop ERP Control (Load 2) 

Data Check (Load 1) 

Data Check (Load 2) 

Diagnostic Write/Read 

Time Out 

Error Post 

Intervention Required 

Unit Exception 

Lost Data 

Read Skip/forite Break Check (Load 1) 

Read Skip/Write Break Check (Load 2) 

Overrun 

Bus Out 

Status Check 



IGE0004A 
IGE0904A 
IGE0104A 
IGE0004B 
IGE0104B 
IGE0204A 
IGE0504A 
IGE0304A 
IGE0304B 
IGE0404A 
IGE0704A 
IGE0404B 
IGE0504B 
IGE0604A 
IGE0804A 
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BSC ERP Routines: 

BTAM BSC ERP Control 

Data Check 

Time Out 

Error Post 

Intervention Required 

Special Return 

Lost Data 

Remote 3270 Error Post Routine 

Bus Out £ Overrun 

Equipment check S Command Reject 

Unit Exception 



IGE0004C 
IGE0104C 
IGE0404C 
IGE0204C 
IGE0304C 
IGE0504C 
IGE0604C 
IGE0704B 
IGE0704C 
IGE0804C 
IGE0904C 



Device I/O Modules (Nonexecutable) 



Start- Stop Terminals: 
IBM 1030 

IBM 1030 (Auto Poll) 
IBM 1050 , Nonswitched 
IBM 1050, Nonswitched (Auto Poll) 
IBM 1050, Switched 
IBM 1050, nonswitched 
IBM 10 50, Switched 
IBM 1060 

IBM 1060 (Auto Poll) 
IBM 2260 (Remote) 
IBM 2740, Basic 
IBM 2740, with Checking 
IBM 2740, with Station Control 
IBM 2740, with Station Control (Auto Poll) 
IBM 2740, with Station Control € Checking 
IBM 2740, with Station Control S Checking (Auto Poll) 
IBM 27 40, with Checking £ 2760 Attachment 
IBM 2740, Dial-up 
IBM 2740, Dial-up, with Checking 
IBM 2740, Dial-uo, with Transmit Control 
IBM 2740, Dial-up, with Transmit Control & Checking 
IBM 2740, Dial-up, with Checking S 2760 Attachment 
IBM 2740, with Checking 
IBM 2740, Dial-up with Checking 
IBM 2741, Nonswitched 
IBM 2741, Switched 
ATST 83B3 
ATST TWX 33/35 
WU 11 5 A 
World Trade Telegraph Terminals 

BSC Stations: 

Nonswitched Point- to-Point (BSC1 2 ) 
Switched Point-to- Point (BSC2 2 ) 
Nonswitched Multipoint (BSC3 2 ) 



IGG019MJ 
IGG019MK 
IGG019MD 
IGG019ME 
IGG019MF 
IGG019PN 
IGG019PO 
IGG019MI 
IGG019M4 
IGG019M3 
IGG019MT 
IGG019M0 
IGG019MZ 
IGG019M2 
IGG019MY 
IGG019M1 
IGG019PL 
IGG019MU 
IGG019MX 
IGG019MW 
IGG019MV 
IGG019PM 
IGG019PP 
IGG019PQ 
IGG019PE 
IGG019PF 
IGG019ML 
IGG019MP 
IGG019MN 
IGG019PB 



IGG019M5 
IGG019M6 
IGG019PC 



Local Station: 
IBM 3270 



IGG019PH 



2 As specified in the UNIT operand of the IODEVICE macro instruction. 
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APEENDIX I: MISCELLANEOUS BOUTINES 



LOCAL 3270 ERP ROUTINES (IGE0010E AND 
IGE0110E) 



The local 32 
and IGE0110E 
error record 
station and 
(The UCB for 
X«69« in the 
the proper E 
in SYS1.SVCL 
IOS transien 



70 EFP routines (IGE0010E 
) handle error recovery and 
ing for the local 3270 display 
the local 3284 cr 3286 printer, 
a local 3270 device has a 
UCBETI field to indicate 
RP.) The ERP rcutines reside 
IB and are executed in the 
t area. 



The local 3270 ERP receives control 
frcm ICS after an I/O error involving 
a local 3270 device has teen detected 
ty the device, the ccntrol unit, or the 
channel. While the error ccndition is 
being processed, all I/O interruptions 
from the device are passed to the ERP 
by IOS. When the ERP has recovered from 
the error condition or has determined 
that it cannot correct the condition, 
the ERP returns control to IOS. 

For the logic flow of the local 3270 
ERP routines (IGGE0010E and IGE0110E), 
see charts X (5 parts) and Y (3 parts) . 



TP RECORDER (IGE0625F) 

The TP recorder (IGE0625F) records in 
SYS1.LCGREC T-type records containing 
information from remote 3270 error status 
(SCH % R) messages. These records have 
the format: 



3270 SCAN (IECTSCAN) 

The 3270 subroutine to change alphanumeric 
(SCAN) converts data streams produced 
by 226C application programs into data 
streams that can be sent to 3270 devices 
and converts data streams received from 
3270 devices into data streams that can 
be processed by 2260 application programs. 

SCAN receives control frcm the expansion 
of the SCANREQ macro instruction, which 
constructs the Display Alphanumeric Control 

Area (EACA) and places into it:\ *^ 

» 

• The addresses and lengths of the 
source and sink areas 

• The device address of the 2260 

• Descriptions of the 2260 and 3270 
screens 

• Switches indicating the type of 
processing (RVOID or PROT or both) 
and the type of 2260 operation 
performed with the source data stream 

SCAN consists of a write subroutine 
that deals with output data streams, a 
read subroutine that deals with input 
data streams, and routines that maintain 
a logical 2260 screen image on a logical 
3270 screen. The read and write subroutines 
communicate through the DACCRS, DACSOMAD, 
DACFLG, and DACIND fields in the DACA. SCAN 
receives as input the DACA, a source data 
stream, and a sink output area. SCAN produces 
as output a converted data stream in the sink 
area, the length of that data stream in 
register 0, and a return code in register 15. 



Buffer 
Size 


Not Used 


XCTL 
Code 


Record 
ID 


CUA 


CU 


DS 


STATl 


STAT2 



2 12 12 111 1 

Length (in Bytes) 

where: 

Buffer Size is X^OOB 1 

Not Used is X^O 1 

XCTL Code is X^OOO 1 indicating that 

control is to be passed to IOS) 
Record ID is X'03 1 
CUA is channel/unit address 
CU/DS/STAT1/STAT2 are information from 

the error status message (translated 

into EBCDIC if it was received in 

ASCII) 

The TP recorder receives control from 
the remote 3270 Error Post routine 
(IGE0704B) and passes control to IOS, 



Figure 24 shows the format of the DACA, 
Table 8 shows the contents of the DACA. 
For the logic flow of SCAN (IECTSCAN) , 
see Chart Z (19 parts). 

Displacement 




12 
16 
20 



Figure 24. Display Alphanumeric Control 
Area (DACA) 



DACCRS 


DACSOMAD 




DACSRCAD 




DACSINAD 


DACSRCLN 


DACSINLN 


DACDSSCR 


DACANSCR 


DACDSAD 


DACOPTYP 


DACFLG 


DACIND 
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Relative 


Bytes and 






Location 


Alignment 


Name 


Contents 





2 C 


)ACCRS 


Binary address of the cursor in the 3270 buffer. 


2 


. . 2 C 


)ACSOMAD 


Binary address of the last set field (SOM) order in the 3270 buffer. 


4 






Temporary save byte: used during conversion from 3270 six-bit to binary. 


5 


. 3 [ 


)ACSRCAD 


Storage address of the source. 


8 






Temporary save byte: used during conversion from 3270 six-bit to binary. 


9 


. 3 C 


)ACSINAD 


Storage address of the sink. 


12 


2 t 


)ACSRCLN 


Binary length of the source. 


14 


. . 2 [ 


)ACSINLN 


Binary length of the sink. 


16 


2 [ 


)ACDSSCR 


2260 screen descriptor: 


16 


1 [ 


)SLINE 


Binary number of lines on the 2260 screen. 


17 


. 1 [ 


)SWIDE 


Binary character width of the 2260 screen. 


18 


. . 2 [ 


)ACANSCR 


3270 screen descriptor: 


18 


. . 1 > 


\NLINE 


Binary number of lines on the 3270 screen. 


19 


... 1 > 


\NWIDE 


Binary character width of the 3270 screen. 


20 


1 I 


DACDSAD 


2260 device address. 


21 


. 1 I 


DACOPTYP 



1 

.1 

. . 1 .... 

... ... 1 


Special processing indicators and BTAM operation used with 2260: 

RVOID = YES. 

PROT = YES. 

Write to cursor. 

Write to line address. 

Write erase. 

Read manual input (Ml). 

Short read manual input (Ml). 

Read buffer. 


22 


. . 1 


DACFLG 



1 

.1 

. . . 1 .... 

1 . 

1 


Flags used by SCAN: 

Cursor positioning switch (BLAT). 

Last read was a short read Ml. 

SOM present in data stream (output). 

Data stream more than 256 bytes. 

SOM present in data stream (input or output). 

No SMI present in data stream (input). 

STX present in data stream. 

Remote device. 


23 


... 1 


DACIND 


Contains offset into the source of the first character that is on an integral 
boundary. 



Table 8, DACA Fields 



SCAN Module Descri pt io n 

Entry Point ; The only entry point is at 
the first executable instruction labeled 
IECTSCAN. 

Input ; Begister 1 contains the address 
of the DACA # which contains information 
supplied by means of the SCANBEQ macro 
instruction. 

O utput : The sink area contains the 
converted data stream. Register contains 
the length of that data stream. Register 
15 contains one of the following return 
codes: 

Normal. 

4 The source area contained only 
an AID character; the sink area 
contains the unaltered AID 
character. (Ihe CLEAR, PA1, PA2, 
or PA3 key on the 3270 keyboard 
was pressed, or the control unit 
could not determine the cause of 
the interruption.) 



8 The sink area is not long enough 
to contain the entire converted 
data stream. (SCANBEQ should be 
reissued with a larger sink area 
provided.) 

C No start of message symbol (SOM 
or SMI) is present in the input 
data stream just processed; the 
operation was not a read buffer 
operation. 

10 An SOH was the first character 
in the data stream (ether than 
an STX) . (On a read operation, 
either a sense/status message was 
received or the operator entered 
a request for test. On a write 
to line address operation, the 
line address character did not 
fall within the valid line addresses 
for a 2260.) 

14 On a read operation, the cursor 
location did not fall within the 
boundaries of the 2260 screen. 
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Z,) Address 


source 


area 


device 


is re 


to one, 


. If 


bit 6 of DAC 


STX is 


place 


on the 


opera 


to a read or 


WRITE: 


(See 



E xternal Ref e rence s: SCAN references the 
DACA through DACAD, the source area through 
EACSRCAD, and the sink area through 
EACSINAD. 

Table/Work Ar eas: SCAN uses the DACA 
provided by the application program. 
SCAN uses translate tables to locate 
certain characters and to convert 
hexadecimal addresses. 

Exits ; SCAN exits by means of a branch 
return on register 14 with a return code 
in register 15. 

Attributes: Reentrant. 



SCAN Subro utines 



Initial. Ho u sekeeping : (See part 1 of Chart 
■7 \ » ^T-^ee. ^j^ty is set up for the 
and the sink area. If the 
mote, bit 7 of BACFLG is set 
the source contains an STX, 
FLG is set to one, and the 
d into the sink. Depending 
ticn type, control is passed 
write subroutine. 

part 2 of Chart Z.) 
Housekeeping related to output data streams 
is done. The opening orders and control 
needed for the 3270 are placed into the 
sink, based on bit 7 of DACFLG and the 
write operation type. Depending on bit 
1 of DACFLG and the contents of EACSOMAD, 
an order may be inserted to remove an 
existing SOM from the 3270 screen. If 
RVOID=N0 for a write erase operation, 
the screen is set to blanks. Control 
is passed to WRITENT. 

WRITENT: (See part 2 of Chart Z.) The 
current 2260 line and current 2260 cursor 
position are established, and the group 
of characters to be dealt with initially 
from the source area is computed for the 
write operation type. For write to cursor 
and write to line address, the 3270 buffer 
position of the first character is placed 
into the sink. ^ For write erase, the 3270 
buffer position is already zero. Control 
is passed to WITCH1. 

WITCH: (See part 3 of Chart Z.) 
Initialization, termination, and data 
stream processing (net involving special 
characters) specifically related to the 
data are done. 

• WITCH1 - If the sink is too small, 
control is passed to OOTSINK. If 
the gr<3up of characters is zero, 
control is passed to WIT. Characters 
that do not require special processing 
are moved into the sink area. If 



a character that requires special pro- 
cessing is found (by means of a translate 
table), a branch (determined by the 
function byte selected frcm the 
table) is made into WRSPCHAR. If 
nc special processing is needed, 
control is passed to NOCHAR. 
NCCHAR - The entire data group is 
moved into the sink. If all data 
has been processed, control is passed 
to WIT; if data remains, control 
is passed to WITCH2. 
WITCH2 - If screen wrap exists, 
control is passed to WALL. Otherwise, 
the cursor is adjusted to the next 
3270 line. If the 2260 and 3270 
screens are not equal, control is 
passed to WITCH3. If they are equal, 
control is passed to WITCHU. 
WITCH3 - An RTA order is inserted 
to place nulls in the excess 3270 
screen. Control is passed to WITCHU. 
WITCH4 - The grouping is set to equal 
the 2260 width. Control is passed 
tc WITCH1. 



WALL: (See part 5 of Chart Z.) The 3270 
screen is formatted to maintain the 2260 
image. If PROT=YES, the protected 
attribute is inserted. The current line 
and the cursor position are set to zero. 
If the 2260 and 3270 screens are not 
equal, control is passed to WITCH3. 
Otherwise, control is passed to WITCH4. 

WRSPCHAR: (See part 13 of Chart Z.) A 
character requiring special processing 
is dealt with by the appropriate 
subroutine. 



WRTNEWL - Processes a new line 

character. Control is passed to 

WITCH2. 

WBTSOM - Processes an SOM symbol. 

Control is passes to SETTLE. 

WRTEOM - Processes an EOM symbol. 

Control is passed to SETTLE. 

WRTETX - Processes and ETX. If the 

device is known to be remote, control 

passes to WIT. Otherwise, control 

returns to the housekeeping 

subroutine. 

WRTNULL - Processes a null. Control 

is passed to SETTLE. 

SETTLE - Housekeeping is done for 

other subroutines. Control is passed 

to WITCH1. 



WIT: (See part 6 of Chart Z.) Processing 
for output data is terminated. If 
PBOT=YES, an SOM is checked for on the 
screen. An insert cursor order is set 
following the last data, and, if it is 
a remote data stream, an ETX is placed 
at the end. Contrcl is passed to OUTNORM. 



Appendix L: Miscellaneous Routines 251 



BEAD: (See part 9 of Chart Z.) If an 
SOH is present, control is passed to 
CUTERR. If the device is remote, the 
3270 device address is replaced by the 
contents of DACDSAD. If the AID character 
indicates that the CLEAR, PA1, PA2, or 
PA3 key was pressed, the AID character 
is placed into the sink (followed by an 
end framing character if needed) , and 
control is passed to OUTSPEC. For a read 
buffer operation, processing begins at 
BEAD1, and control passes to BBLAT and 
back to READ1 after each line has been 
processed. When the last 2260 line has 
teen processed, control is passed to 
BEADOUT. For other read operations, the 
cursor position is related to a storage 
address. If an SBA seguence is present, 
the field position is related to a storage 
address, and control is passed to SOURTST. 
If no SBA sequence is present, control 
is passed to CKSMI. 

SOURTST: (See part 10 of Chart Z.) The 
boundaries of data ccnversion are 
established, and a branch is taken to 
BDLAT. 

• CKSMI - An SMI (X^A") is searched 
for in the data stream. If one is 
found, its position becomes the field 
position, and control is passed to 
SCUBTST. If no SMI is found, bit 

5 in DACFLG is set to cne, and control 
is passed to READOUT. 

• READOUT - An ETX is inserted if 
needed, and a branch is taken to 
OUT NORM. 



BDLAT: (See part 11 
Characters that do n 
processing are moved 
If a character that 
processing is found 
translate table) , a 
by the function byte 
table) is made into 
processing is needed 
to BDMCV. 



of Chart z.) 

ct require special 

into the sink area, 
requires special 
(by means of a 
branch (determined 

selected frcm the 
KEBF. If no special 
, control is passed 



is dealt with by the appropriate 
subroutine. 

• BDSCM - Processes a start field. 
Control is passed to BESMI. 

• RESMI - Processes an operator-entered 
SCM (X^A 1 )- Control is passed to 
DATLNTST. 

• RDECM - Processes an ECM. Control 
is passed to DATLNTST. 

• RDFLDMK - Processes a 3270 field 
mark. Control is passed to DATLNTST. 

• RDETX - Processes an ETX. If the 
device is remote, control is passed 
to READOUT. Otherwise, control 
returns to the housekeeping 
subroutine. 

• REBSOM - Processes a start field. 
Control is passed to RDBSMI. 

• RDBSMI - Processes an operator- entered 
SCM (X^A 1 )* Control is passed to 
INCREM. 

• REBEOM - Processes an EOM. Control 
is passed to INCREM. 

• RDBFM - Processes a field mark. 
Control is passed to INCREM. 

• RDNULL - Processes a null or invalid 
character. For read buffer operation, 
control passes to INCBEM. Otherwise, 
control passes to DATLNTST. 

• DATLNTST - Handles return for a 
normal read. If the remaining group 
is zero, control passes to MORTST. 
Otherwise, control passes to RDLAT. 

• INCREM - Handles return for a read 
buffer. If the remaining group is 
zero, the source is pointed to the 
next line, the line is incremented, and 
control is passed to READ1. 
Otherwise, control is passed to 
RDLAT. 

INVERT; (See part 19 of Chart Z.) Incoming 
3270 addresses are converted to hexadecimal 
addresses. 

OUTVERT: (See part 19 of Chart Z.) 
Outgoing 3270 addresses are converted 
to 327C addresses. 



RDMOV - The entire group is moved 
into the sink. Control is passed 
to MORTST. 

MORTST - If nothing remains in the 
source area to process, control is 
passed to BEADOUT. Otherwise, for 
a read buffer operation, the current 
line is incremented, the source 
pointer is set at the beginning of 
the line, and control is passed to 
READ1. For other read operations, 
the length is set to 255 or all 
remaining data, and control is passed 
to RDLAT. 



KERF: (See part 16 of Chart Z.) A 
character reguiring special processing 



CUTPROC: (See part 7 of Chart Z. ) A 
special function is performed by the 
appropriate condition return processor, 
register 15 is loaded with a 16 (X'10 1 ), 
and control is passed to a point that 
leaves the reguired return code in register 
15. 



OUTNORM - If bit 5 of EACFLG is set 
to one, control is passed to OUTNSMI. 
If bit 4 of DACFLG is set to one 
and the operation is a write, the 
SOM address is saved in EACSOMAD. 
If bit 4 of DACFLG and bit 6 of 
DACCPTIP are set to zero, a halfword 
of ones is placed into DACSCMAD. 
Control is passed to GOBACK00. 
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• OUTSPEC - Control is passed to 
GOBACK04- 

• OUTSINK - Control is passed to 
GOBACK08. 

• OUTNSMI - Control is passed to 
GOBACKOC. 

• CUTEBR - Control is passed to 
GOBACK10. 



Appendix L: Miscellaneous Routines 253 



INDEX 



abnormal end appendage 

description 26-28 

logic flow 146-154 
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ASMTRTAB macro instruction 1 
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BTAM control blocks 10-11 
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BTAM routines 22-248 
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request queue 20,31 

routine (IGG019MS) 
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logic flow 1 37 
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buffering, dynamic ( see dynamic buffering) 



Change Entry routine (IECTCHGN) 31-32 
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function 26 

logic flow 146-154 
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general information 40-42 
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CHGNTRY macro instruction 9 
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description 36 

logic flow 141 
command codes 40, 41 
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completion codes 235 



data control block (DCB) 

creation 1 

description 226 

fields 227-229 

format 226 

function 1 
data definition (DD) statement 10, 
data event control block (DECB) 

creation 1 1 

descriptions 236 

fields 11, 237-240 

format 236 

function 9, 11, 17 
data extent block (DEB) 

creation 10 

description 230 

fields 231 

format 230 

function 10, 12 
data set, line group 

concatenation 1 2 

definition 11-13 

opening 1 3 
DATAMGT macro instruction 13 
DCB ( see data control block) 
DCB macro instruction 9 
DD (data definition) statement 11 
DDNAME parameter for DCB 10 
DEB ( see data extent block) 
DECB ( see data event control block) 
device codes 243-244 
device I/O directory 23, 38-39 

format 39 

providing additional space in 23 
device I/O module 36-37, 38 

example 37 

format 36-37 

lists of 38, 245-248 
DFTRMLST macro instruction 
dynamic buffering 

description 20, 28 

logic flow 19, 20 

Read/Write CCWs 29 



ECB ( see event control block) 
Edit routine (IECTEDIT) 32 

logic flow 207-211 
error counters 9 
error recovery procedures (ERP) 
(see also local 3270) 30 
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description 11 , 235 
format 235 
function 1 1 

features, optional 243-244 



local 3270 second-level attention 
routine (IGG019PG) 
description 30.1 
logic flow 156.1 
LOPEN macro instruction 9 f 33 



macro instruction 
assembly 13 
categories 9 



Input/Output block (IOB) 

creation 1 1 
CSW field 232 

description 232 

fields 234 

format 232, 233 

function 1 1 
interruption queue element (IQE) 

description 244.5 

fields 244.5 

format 244.5 

function 1 2 
interruption request block (IRB) 

description 244.3 

fields 244.3 

format 244.3 

function 1 2 
IOCONTRL macro instruction 13 
IODEVICE macro instruction 13 



LERB macro instruction 9 
LERPRT macro instruction 9, 32 
Line Error Print (IECTLERP) routine 
description 32 
logic flow 182 
line group 

defining 11-13 
opening 1 4 
line group data set 

group) 
Line Open (IECTLOPN) 

logic flow 138 
local 3270 BTAM Open executor (IGG0194P, 
IGG0194Q) 

description 23 
logic flow 136.1 , 136.4 
local 3270 BTAM SVC routine (IECTSVC) 
description 30.1 
logic flow 156.2 
local 3270 channel end/abnormal 
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154.1 
routines ( IGE00 1 0E , 
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routine 33 



description 
logic flow 
local 3270 ERP 
IGE0110E) 
description 
logic flow 
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local 3270 first-level attention routine 
(IECTATEN) 

description 30 
logic flow 156 



ONLTST macro instruction 34 
on-line test 

description 34-35 

list of modules 34 

logic flow 156-161, 212-224 

RFT messages 34-35 

types, BSC 35 
I Open executor ( see also local 3270) 
12, 14, 22, 23 

description 14, 22,23 

logic flow 129-136 
opening line groups 14 
OPEN macro instruction 9 
optional feature codes 243-244 



Poll command (Auto Poll) 21 
Program controlled interrupt (PCI) 
appendage (IGG019MC) 

description 28-29 

logic flow 155 

with dynamic buffering 17, 28 
program request block (PRB) 11 



Read Initial operation (local 3270) 20, 20.1 
READ macro instruction 9, 10 
Read operation 

completion 15, 17-18 

evolution of 13-19 

execution 1 3 

local 3270 20, 20.2 

logic flow 16 

types 37-38 
Read/Write routine (IGG019MA) 

area address subroutines 24-25 

count subroutines 25-26 

description 23-26 

functions 24 

logic flow 142-145 

purpose 17 
relative line numbers 1 2 
RELBUF macro instruction 9, 20, 35 
remote 3270 Error Post routine (IGE0704B) 

description 30.4 

logic flow 194 
REQBUF macro instruction 9, 20, 35 
REQBUF/RELBUF (IGC058) routine 35 
RESETPL macro instruction 10 
| RESETPL operation (local 3270) 20.3, 20.5 
RFT (request-for-test) message 34-35 
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SVC 58 (IGC058) routine 
description 35-36 
logic flow 140 

SYS1.TELCMLIB 13 



table of offsets 17, 36-37 
table of special characters 38 
TELCMLIB macro instruction 13 
| TP recorder (IGE0625F) , description 
TPEDIT macro instruction 32 
Tp-Op codes 

definition 36 

invalid 36 

location 36 

summary 41-42 
Translate (IECTTRNS) routine 

description 33-34 

logic flow 139 
TRNSLATE macro instruction 10 , 33 
TWAIT macro instruction 10,11 
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unit control block (UCB) 
creation 1 1 
description 241 
device codes 243-244 
device type word 243-244 
fields 242 
format 241 
function 1 1 

graphic devices segment 241, 242 
system generation 1 1 



WAIT macro 1 1 

World Trade telegraph channel end 
appendage 152-154 

WRITE macro instruction 9, 10 
Write operation 

local 3270 20, 20.2 

types 37-38 
2741 Break routine, logic flow 206 
3270 SCAN (IECTSCAN) 

description 249 

logic flow 224.16 
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